Integració per API
Mostra el catàleg de cursos i els episodis del pòdcast de Somos Motor a la teva app. El teu enllaç d’afiliat s’inclou automàticament a cada curs.
Verificant l’accés…
Accés a l’API no activat
L’accés a l’API està disponible per a partners amb integració directa. Si tens una app i vols mostrar els nostres cursos, contacta amb l’equip.
Contactar amb l’equipLa teva API key
Genera o regenera la teva clau d’accés a l’API. Per seguretat, només es mostra una vegada.
Desa-la ara: per seguretat no es tornarà a mostrar. Si la perds, genera’n una de nova amb aquest botó (l’anterior quedarà invalidada).
Si ja tens una key activa i prems Generar, l’anterior queda invalidada a l’instant. Revocar anuŀla la teva key actual sense crear-ne una altra: deixa de funcionar immediatament (per tornar a tenir accés, genera’n una de nova).
Documentació de l’API
Tota la guia d’integració (endpoints, autenticació, límits, exemples i les regles per integrar-la bé). Copia-la i enganxa-la a la teva IA perquè la implementi a l’instant.
No saps què és això? Glossari ràpid
Endpoint: catàleg de cursos
Crida aquest endpoint per obtenir els cursos disponibles amb els teus preus personalitzats.
Endpoint: catàleg de cursos
Crida aquest endpoint per obtenir els cursos disponibles amb els teus preus personalitzats.
URL
GET https://somosmotor.es/v1/cursos
Respon en JSON. Memòria cau pública de 10 minuts (es recomana respectar el Cache-Control).
Autenticació
Inclou la teva API key d’una d’aquestes maneres:
x-api-key: LA_TEVA_API_KEY
Authorization: Bearer LA_TEVA_API_KEY Límits
60
req/min per API key
10 min
memòria cau pública del feed
Estructura de la resposta (exemple amb les teves dades reals)
Carregant l’exemple amb les teves dades… Aquest exemple fa servir el teu descompte real sobre un curs de mostra de 180 €, perquè vegis exactament què retorna l’API. url_inscripcion ja porta el teu ?ref= incrustat.
Descompte i comissió no són el mateix. El descompte (el que veus a dalt a precio_con_descuento_eur) és el que es rebaixa al teu client per fer servir el teu codi. La teva comissió és el que guanyes tu per cada venda: no viatja en aquest feed (és privada), la consultes al teu panell de Comissions.
Exemple (curl)
curl -H "x-api-key: LA_TEVA_API_KEY" \
https://somosmotor.es/v1/cursos Codis d’error
| Codi | Significat |
|---|---|
| 401 | API key invàlida, absent o partner desactivat |
| 403 | API key sense l’scope "catalogo" |
| 429 | Massa peticions (límit de 60 req/min) |
| 500 | Error intern. Torna-ho a provar d’aquí a uns segons |
Endpoint: episodis del pòdcast
Crida aquest endpoint per obtenir els episodis publicats del pòdcast (àudio MP3 + vídeo de YouTube).
Endpoint: episodis del pòdcast
Crida aquest endpoint per obtenir els episodis publicats del pòdcast (àudio MP3 + vídeo de YouTube).
URL
GET https://somosmotor.es/v2/podcast
Respon en JSON. Memòria cau pública de 10 minuts (es recomana respectar el Cache-Control). Retorna els episodis amb àudio publicat, ordenats del més recent al més antic.
Autenticació
La mateixa API key que l’endpoint de cursos. Inclou-la d’una d’aquestes maneres:
x-api-key: LA_TEVA_API_KEY
Authorization: Bearer LA_TEVA_API_KEY Límits
60
req/min per API key
10 min
memòria cau pública del feed
Camps de cada episodi
| Camp | Què és |
|---|---|
| id / slug | Identificador únic i slug de l’episodi |
| numero | Número d’episodi |
| titulo / teaser | Títol i resum curt |
| fecha_publicacion | Data (YYYY-MM-DD) |
| invitados | Llista de convidats de l’episodi |
| imagen_url | Portada de l’episodi |
| duracion_segundos | Durada en segons |
| audio_url | MP3 estable de l’àudio (reproductor propi) |
| youtube_url | Vídeo a YouTube (per incrustar amb iframe) |
| spotify_url / apple_podcasts_url / ivoox_url | Enllaços a les plataformes (si n’hi ha) |
| url_episodio | Pàgina de l’episodi a somosmotor.es (porta el teu ?ref=) |
Estructura de la resposta (exemple amb el teu enllaç real)
Carregant l’exemple… Com reproduir el vídeo
El vídeo viu a YouTube (no servim fitxers de vídeo). Treu l’ID de youtube_url i insereix-lo amb un iframe, igual que al nostre web:
<iframe src="https://www.youtube.com/embed/VIDEO_ID?rel=0" allowfullscreen></iframe> Per reproduir només l’àudio, fes servir audio_url (MP3) en un reproductor propi.
Exemple (curl)
curl -H "x-api-key: LA_TEVA_API_KEY" \
https://somosmotor.es/v2/podcast Codis d’error
| Codi | Significat |
|---|---|
| 401 | API key invàlida, absent o partner desactivat |
| 403 | API key sense l’scope "podcast" |
| 429 | Massa peticions (límit de 60 req/min) |
| 500 | Error intern. Torna-ho a provar d’aquí a uns segons |
També disponible: RSS públic
Si només vols el feed d’àudio estàndard (Spotify/Apple/iVoox), hi ha un RSS 2.0 públic que no requereix API key:
GET https://somosmotor.es/podcast/rss.xml
Com funciona l’atribució
- L’usuari de la teva app prem «Inscriure’s» en un curs.
- La teva app obre la
url_inscripciondel feed al navegador del dispositiu. - L’usuari arriba a
somosmotor.esamb el teu?ref=. La cookie es guarda 30 dies. - Somos Motor gestiona el pagament (Stripe). El teu descompte s’aplica automàticament.
- La venda s’atribueix al teu codi. La comissió apareix al teu panell d’afiliat.