Integrazione tramite API
Mostra il catalogo dei corsi e gli episodi del podcast di Siamo Motori nella tua app. Il tuo link di affiliato è incluso automaticamente in ogni corso.
Verifica dell’accesso…
Accesso API non attivato
L’accesso all’API è disponibile per i partner con integrazione diretta. Se hai un’app e vuoi mostrare i nostri corsi, contatta il team.
Contatta il teamLa tua API key
Genera o rigenera la tua chiave di accesso all’API. Per sicurezza viene mostrata una sola volta.
Salvala adesso: per sicurezza non verrà mostrata di nuovo. Se la perdi, generane una nuova con questo pulsante (la precedente verrà invalidata).
Se hai già una key attiva e premi Genera, la precedente viene invalidata all’istante. Revoca annulla la tua key attuale senza crearne un’altra: smette di funzionare subito (per riavere l’accesso, generane una nuova).
Documentazione dell’API
Tutta la guida all’integrazione (endpoint, autenticazione, limiti, esempi e le regole per integrarla bene). Copiala e incollala nella tua IA perché la implementi subito.
Non sai cos’è? Glossario rapido
Endpoint: catalogo dei corsi
Chiama questo endpoint per ottenere i corsi disponibili con i tuoi prezzi personalizzati.
Endpoint: catalogo dei corsi
Chiama questo endpoint per ottenere i corsi disponibili con i tuoi prezzi personalizzati.
URL
GET https://somosmotor.es/v1/cursos
Risponde in JSON. Cache pubblica di 10 minuti (si consiglia di rispettare il Cache-Control).
Autenticazione
Includi la tua API key in uno di questi modi:
x-api-key: TUA_API_KEY
Authorization: Bearer TUA_API_KEY Limiti
60
req/min per API key
10 min
cache pubblica del feed
Struttura della risposta (esempio con i tuoi dati reali)
Caricamento dell’esempio con i tuoi dati… Questo esempio applica il tuo sconto reale a un corso di prova da 180 €, così vedi esattamente cosa restituisce l’API. url_inscripcion contiene già il tuo ?ref=.
Sconto e commissione non sono la stessa cosa. Lo sconto (quello che vedi sopra in precio_con_descuento_eur) è ciò che risparmia il tuo cliente usando il tuo codice. La tua commissione è ciò che guadagni tu su ogni vendita: non viaggia in questo feed (è privata), la consulti nel tuo pannello Commissioni.
Esempio (curl)
curl -H "x-api-key: TUA_API_KEY" \
https://somosmotor.es/v1/cursos Codici di errore
| Codice | Significato |
|---|---|
| 401 | API key non valida o assente, oppure partner disattivato |
| 403 | API key senza lo scope “catalogo” |
| 429 | Troppe richieste (limite di 60 req/min) |
| 500 | Errore interno. Riprova tra qualche secondo |
Endpoint: episodi del podcast
Chiama questo endpoint per ottenere gli episodi pubblicati del podcast (audio MP3 + video di YouTube).
Endpoint: episodi del podcast
Chiama questo endpoint per ottenere gli episodi pubblicati del podcast (audio MP3 + video di YouTube).
URL
GET https://somosmotor.es/v2/podcast
Risponde in JSON. Cache pubblica di 10 minuti (si consiglia di rispettare il Cache-Control). Restituisce gli episodi con audio pubblicato, dal più recente al più vecchio.
Autenticazione
La stessa API key dell’endpoint dei corsi. Includila in uno di questi modi:
x-api-key: TUA_API_KEY
Authorization: Bearer TUA_API_KEY Limiti
60
req/min per API key
10 min
cache pubblica del feed
Campi di ogni episodio
| Campo | Cos’è |
|---|---|
| id / slug | Identificativo univoco e slug dell’episodio |
| numero | Numero dell’episodio |
| titulo / teaser | Titolo e breve riassunto |
| fecha_publicacion | Data (YYYY-MM-DD) |
| invitados | Elenco degli ospiti dell’episodio |
| imagen_url | Copertina dell’episodio |
| duracion_segundos | Durata in secondi |
| audio_url | MP3 stabile dell’audio (player proprio) |
| youtube_url | Video su YouTube (da incorporare con un iframe) |
| spotify_url / apple_podcasts_url / ivoox_url | Link alle piattaforme (se esistono) |
| url_episodio | Pagina dell’episodio su somosmotor.es (contiene il tuo ?ref=) |
Struttura della risposta (esempio con il tuo link reale)
Caricamento dell’esempio… Come riprodurre il video
Il video è su YouTube (non serviamo file video). Prendi l’ID da youtube_url e incorporalo con un iframe, come sul nostro sito:
<iframe src="https://www.youtube.com/embed/VIDEO_ID?rel=0" allowfullscreen></iframe> Per riprodurre solo l’audio, usa audio_url (MP3) in un player tuo.
Esempio (curl)
curl -H "x-api-key: TUA_API_KEY" \
https://somosmotor.es/v2/podcast Codici di errore
| Codice | Significato |
|---|---|
| 401 | API key non valida o assente, oppure partner disattivato |
| 403 | API key senza lo scope “podcast” |
| 429 | Troppe richieste (limite di 60 req/min) |
| 500 | Errore interno. Riprova tra qualche secondo |
Disponibile anche: RSS pubblico
Se vuoi solo il feed audio standard (Spotify/Apple/iVoox), c’è un RSS 2.0 pubblico che non richiede API key:
GET https://somosmotor.es/podcast/rss.xml
Come funziona l’attribuzione
- L’utente della tua app tocca «Iscriviti» su un corso.
- La tua app apre la
url_inscripciondel feed nel browser del dispositivo. - L’utente arriva su
somosmotor.escon il tuo?ref=. Il cookie viene conservato per 30 giorni. - Siamo Motori gestisce il pagamento (Stripe). Il tuo sconto viene applicato automaticamente.
- La vendita viene attribuita al tuo codice. La commissione compare nel tuo pannello affiliato.