Integracion por API
Muestra el catalogo de cursos y los episodios del podcast de Somos Motor en tu app. Tu enlace de afiliado se incluye automaticamente en cada curso.
Verificando acceso...
Acceso API no activado
El acceso a la API esta disponible para partners con integracion directa. Si tienes una app y quieres mostrar nuestros cursos, contacta con el equipo.
Contactar con el equipoTu API key
Genera o regenera tu clave de acceso a la API. Por seguridad, solo se muestra una vez.
Guárdala ahora: por seguridad no se volverá a mostrar. Si la pierdes, genera una nueva con este botón (la anterior quedará invalidada).
Si ya tienes una key activa y pulsas Generar, la anterior queda invalidada al instante. Revocar anula tu key actual sin crear otra: deja de funcionar de inmediato (para volver a tener acceso, genera una nueva).
Documentación de la API
Toda la guía de integración (endpoints, autenticación, límites, ejemplos y las reglas para integrarla bien). Cópiala y pégasela a tu IA para que la implemente al instante.
¿No sabes qué es esto? Glosario rápido
Endpoint: catalogo de cursos
Llama a este endpoint para obtener los cursos disponibles con tus precios personalizados.
Endpoint: catalogo de cursos
Llama a este endpoint para obtener los cursos disponibles con tus precios personalizados.
URL
GET https://somosmotor.es/v1/cursos
Responde en JSON. Cache publica de 10 minutos (recomendado respetar el Cache-Control).
Autenticacion
Incluye tu API key en cualquiera de estas formas:
x-api-key: TU_API_KEY
Authorization: Bearer TU_API_KEY
Limites
60
req/min por API key
10 min
cache publica del feed
Estructura de respuesta (ejemplo con tus datos reales)
Cargando ejemplo con tus datos...
Este ejemplo usa tu descuento real sobre un curso de muestra de 180 €, para que veas exactamente qué devuelve la API.
url_inscripcion ya lleva tu ?ref= incrustado.
Descuento y comisión no son lo mismo. El descuento (el que ves arriba en precio_con_descuento_eur) es lo que se rebaja a tu cliente por usar tu código. Tu comisión es lo que ganas tú por cada venta: no viaja en este feed (es privada), la consultas en tu panel de Comisiones.
Ejemplo (curl)
curl -H "x-api-key: TU_API_KEY" \
https://somosmotor.es/v1/cursos Codigos de error
| Codigo | Significado |
|---|---|
| 401 | API key invalida, ausente o partner desactivado |
| 403 | API key sin el scope "catalogo" |
| 429 | Demasiadas peticiones (limite 60 req/min) |
| 500 | Error interno. Reintenta en unos segundos |
Endpoint: episodios del podcast
Llama a este endpoint para obtener los episodios publicados del podcast (audio MP3 + vídeo de YouTube).
Endpoint: episodios del podcast
Llama a este endpoint para obtener los episodios publicados del podcast (audio MP3 + vídeo de YouTube).
URL
GET https://somosmotor.es/v2/podcast
Responde en JSON. Cache publica de 10 minutos (recomendado respetar el Cache-Control). Devuelve los episodios con audio publicado, ordenados del mas reciente al mas antiguo.
Autenticacion
Misma API key que el endpoint de cursos. Incluyela en cualquiera de estas formas:
x-api-key: TU_API_KEY
Authorization: Bearer TU_API_KEY
Limites
60
req/min por API key
10 min
cache publica del feed
Campos de cada episodio
| Campo | Que es |
|---|---|
| id / slug | Identificador unico y slug del episodio |
| numero | Numero de episodio |
| titulo / teaser | Titulo y resumen corto |
| fecha_publicacion | Fecha (YYYY-MM-DD) |
| invitados | Lista de invitados del episodio |
| imagen_url | Portada del episodio |
| duracion_segundos | Duracion en segundos |
| audio_url | MP3 estable del audio (reproductor propio) |
| youtube_url | Video en YouTube (para embeber con iframe) |
| spotify_url / apple_podcasts_url / ivoox_url | Enlaces a las plataformas (si existen) |
| url_episodio | Pagina del episodio en somosmotor.es (lleva tu ?ref=) |
Estructura de respuesta (ejemplo con tu enlace real)
Cargando ejemplo...Como reproducir el video
El video vive en YouTube (no servimos archivos de video). Saca el ID de youtube_url y embebelo con un iframe, igual que en nuestra web:
<iframe src="https://www.youtube.com/embed/VIDEO_ID?rel=0" allowfullscreen></iframe>
Para reproducir solo el audio, usa audio_url (MP3) en un reproductor propio.
Ejemplo (curl)
curl -H "x-api-key: TU_API_KEY" \
https://somosmotor.es/v2/podcast Codigos de error
| Codigo | Significado |
|---|---|
| 401 | API key invalida, ausente o partner desactivado |
| 403 | API key sin el scope "podcast" |
| 429 | Demasiadas peticiones (limite 60 req/min) |
| 500 | Error interno. Reintenta en unos segundos |
Tambien disponible: RSS publico
Si solo quieres el feed de audio estandar (Spotify/Apple/iVoox), hay un RSS 2.0 publico que no requiere API key:
GET https://somosmotor.es/podcast/rss.xml
Como funciona la atribucion
- El usuario de tu app pulsa "Inscribirse" en un curso.
- Tu app abre la
url_inscripciondel feed en el navegador del dispositivo. - El usuario llega a
somosmotor.escon tu?ref=. La cookie se guarda 30 dias. - Somos Motor gestiona el pago (Stripe). Tu descuento se aplica automaticamente.
- La venta se atribuye a tu codigo. La comision aparece en tu panel de afiliado.