Integração por API
Mostre o catálogo de cursos e os episódios do podcast da Gente do Motor na sua app. O seu link de afiliado é incluído automaticamente em cada curso.
A verificar o acesso…
Acesso à API não ativado
O acesso à API está disponível para parceiros com integração direta. Se tem uma app e quer mostrar os nossos cursos, contacte a equipa.
Contactar a equipaA sua API key
Gere ou regenere a sua chave de acesso à API. Por segurança, só é mostrada uma vez.
Guarde-a agora: por segurança, não voltará a ser mostrada. Se a perder, gere uma nova com este botão (a anterior ficará invalidada).
Se já tem uma key ativa e carregar em Gerar, a anterior fica invalidada de imediato. Revogar anula a sua key atual sem criar outra: deixa de funcionar imediatamente (para voltar a ter acesso, gere uma nova).
Documentação da API
Todo o guia de integração (endpoints, autenticação, limites, exemplos e as regras para a integrar bem). Copie-o e cole-o na sua IA para que o implemente de imediato.
Não sabe o que é isto? Glossário rápido
Endpoint: catálogo de cursos
Chame este endpoint para obter os cursos disponíveis com os seus preços personalizados.
Endpoint: catálogo de cursos
Chame este endpoint para obter os cursos disponíveis com os seus preços personalizados.
URL
GET https://somosmotor.es/v1/cursos
Responde em JSON. Cache pública de 10 minutos (recomenda-se respeitar o Cache-Control).
Autenticação
Inclua a sua API key de uma destas formas:
x-api-key: A_SUA_API_KEY
Authorization: Bearer A_SUA_API_KEY Limites
60
req/min por API key
10 min
cache pública do feed
Estrutura da resposta (exemplo com os seus dados reais)
A carregar o exemplo com os seus dados… Este exemplo aplica o seu desconto real a um curso de amostra de 180 €, para que veja exatamente o que a API devolve. url_inscripcion já inclui o seu ?ref=.
Desconto e comissão não são a mesma coisa. O desconto (o que vê acima em precio_con_descuento_eur) é o que se abate ao seu cliente por usar o seu código. A sua comissão é o que você ganha por cada venda: não viaja neste feed (é privada), consulta-a no seu painel de Comissões.
Exemplo (curl)
curl -H "x-api-key: A_SUA_API_KEY" \
https://somosmotor.es/v1/cursos Códigos de erro
| Código | Significado |
|---|---|
| 401 | API key inválida ou ausente, ou parceiro desativado |
| 403 | API key sem o scope «catalogo» |
| 429 | Demasiados pedidos (limite de 60 req/min) |
| 500 | Erro interno. Tente novamente dentro de alguns segundos |
Endpoint: episódios do podcast
Chame este endpoint para obter os episódios publicados do podcast (áudio MP3 + vídeo do YouTube).
Endpoint: episódios do podcast
Chame este endpoint para obter os episódios publicados do podcast (áudio MP3 + vídeo do YouTube).
URL
GET https://somosmotor.es/v2/podcast
Responde em JSON. Cache pública de 10 minutos (recomenda-se respeitar o Cache-Control). Devolve os episódios com áudio publicado, do mais recente ao mais antigo.
Autenticação
A mesma API key do endpoint de cursos. Inclua-a de uma destas formas:
x-api-key: A_SUA_API_KEY
Authorization: Bearer A_SUA_API_KEY Limites
60
req/min por API key
10 min
cache pública do feed
Campos de cada episódio
| Campo | O que é |
|---|---|
| id / slug | Identificador único e slug do episódio |
| numero | Número do episódio |
| titulo / teaser | Título e resumo curto |
| fecha_publicacion | Data (YYYY-MM-DD) |
| invitados | Lista de convidados do episódio |
| imagen_url | Capa do episódio |
| duracion_segundos | Duração em segundos |
| audio_url | MP3 estável do áudio (leitor próprio) |
| youtube_url | Vídeo no YouTube (para incorporar com iframe) |
| spotify_url / apple_podcasts_url / ivoox_url | Links para as plataformas (se existirem) |
| url_episodio | Página do episódio em somosmotor.es (inclui o seu ?ref=) |
Estrutura da resposta (exemplo com o seu link real)
A carregar o exemplo… Como reproduzir o vídeo
O vídeo está no YouTube (não servimos ficheiros de vídeo). Extraia o ID de youtube_url e incorpore-o com um iframe, tal como no nosso site:
<iframe src="https://www.youtube.com/embed/VIDEO_ID?rel=0" allowfullscreen></iframe> Para reproduzir apenas o áudio, use audio_url (MP3) num leitor próprio.
Exemplo (curl)
curl -H "x-api-key: A_SUA_API_KEY" \
https://somosmotor.es/v2/podcast Códigos de erro
| Código | Significado |
|---|---|
| 401 | API key inválida ou ausente, ou parceiro desativado |
| 403 | API key sem o scope «podcast» |
| 429 | Demasiados pedidos (limite de 60 req/min) |
| 500 | Erro interno. Tente novamente dentro de alguns segundos |
Também disponível: RSS público
Se só quer o feed de áudio padrão (Spotify/Apple/iVoox), existe um RSS 2.0 público que não requer API key:
GET https://somosmotor.es/podcast/rss.xml
Como funciona a atribuição
- O utilizador da sua app carrega em «Inscrever-se» num curso.
- A sua app abre a
url_inscripciondo feed no navegador do dispositivo. - O utilizador chega a
somosmotor.escom o seu?ref=. O cookie é guardado durante 30 dias. - A Gente do Motor trata do pagamento (Stripe). O seu desconto é aplicado automaticamente.
- A venda é atribuída ao seu código. A comissão aparece no seu painel de afiliado.