Integration per API
Zeige den Kurskatalog und die Podcast-Folgen von Motorleute in deiner App an. Dein Partner-Link ist automatisch in jedem Kurs enthalten.
Zugriff wird geprüft…
API-Zugang nicht aktiviert
Der API-Zugang steht Partnern mit direkter Integration zur Verfügung. Wenn du eine App hast und unsere Kurse anzeigen möchtest, wende dich an das Team.
Team kontaktierenDein API-Schlüssel
Erzeuge oder erneuere deinen Zugangsschlüssel für die API. Aus Sicherheitsgründen wird er nur einmal angezeigt.
Speichere ihn jetzt: Aus Sicherheitsgründen wird er nicht noch einmal angezeigt. Wenn du ihn verlierst, erzeuge mit diesem Button einen neuen (der bisherige wird ungültig).
Wenn du bereits einen aktiven Schlüssel hast und auf Erzeugen klickst, wird der bisherige sofort ungültig. Widerrufen hebt deinen aktuellen Schlüssel auf, ohne einen neuen anzulegen: Er funktioniert sofort nicht mehr (um wieder Zugang zu haben, erzeuge einen neuen).
API-Dokumentation
Die gesamte Integrationsanleitung (Endpoints, Authentifizierung, Limits, Beispiele und die Regeln für eine saubere Integration). Kopiere sie und füge sie in deine KI ein, damit sie sie sofort umsetzt.
Du weißt nicht, was das ist? Kurzes Glossar
Endpoint: Kurskatalog
Rufe diesen Endpoint auf, um die verfügbaren Kurse mit deinen persönlichen Preisen zu erhalten.
Endpoint: Kurskatalog
Rufe diesen Endpoint auf, um die verfügbaren Kurse mit deinen persönlichen Preisen zu erhalten.
URL
GET https://somosmotor.es/v1/cursos
Antwortet in JSON. Öffentlicher Cache von 10 Minuten (bitte den Cache-Control beachten).
Authentifizierung
Sende deinen API-Schlüssel auf eine dieser Arten mit:
x-api-key: DEIN_API_KEY
Authorization: Bearer DEIN_API_KEY Limits
60
Anfragen/Min. pro API-Schlüssel
10 Min.
öffentlicher Cache des Feeds
Struktur der Antwort (Beispiel mit deinen echten Daten)
Beispiel mit deinen Daten wird geladen… Dieses Beispiel wendet deinen echten Rabatt auf einen Beispielkurs für 180 € an, damit du genau siehst, was die API zurückgibt. url_inscripcion enthält bereits dein ?ref=.
Rabatt und Provision sind nicht dasselbe. Der Rabatt (den du oben in precio_con_descuento_eur siehst) ist das, was deine Kundin oder dein Kunde für die Nutzung deines Codes spart. Deine Provision ist das, was du an jedem Verkauf verdienst: Sie wird in diesem Feed nicht mitgeliefert (sie ist privat), du siehst sie in deinem Bereich Provisionen.
Beispiel (curl)
curl -H "x-api-key: DEIN_API_KEY" \
https://somosmotor.es/v1/cursos Fehlercodes
| Code | Bedeutung |
|---|---|
| 401 | Ungültiger oder fehlender API-Schlüssel oder Partner deaktiviert |
| 403 | API-Schlüssel ohne den Scope „catalogo“ |
| 429 | Zu viele Anfragen (Limit 60 Anfragen/Min.) |
| 500 | Interner Fehler. Versuche es in ein paar Sekunden erneut |
Endpoint: Podcast-Folgen
Rufe diesen Endpoint auf, um die veröffentlichten Podcast-Folgen zu erhalten (MP3-Audio + YouTube-Video).
Endpoint: Podcast-Folgen
Rufe diesen Endpoint auf, um die veröffentlichten Podcast-Folgen zu erhalten (MP3-Audio + YouTube-Video).
URL
GET https://somosmotor.es/v2/podcast
Antwortet in JSON. Öffentlicher Cache von 10 Minuten (bitte den Cache-Control beachten). Liefert die Folgen mit veröffentlichtem Audio, von der neuesten zur ältesten.
Authentifizierung
Derselbe API-Schlüssel wie beim Kurs-Endpoint. Sende ihn auf eine dieser Arten mit:
x-api-key: DEIN_API_KEY
Authorization: Bearer DEIN_API_KEY Limits
60
Anfragen/Min. pro API-Schlüssel
10 Min.
öffentlicher Cache des Feeds
Felder jeder Folge
| Feld | Bedeutung |
|---|---|
| id / slug | Eindeutige Kennung und Slug der Folge |
| numero | Folgennummer |
| titulo / teaser | Titel und kurze Zusammenfassung |
| fecha_publicacion | Datum (YYYY-MM-DD) |
| invitados | Liste der Gäste der Folge |
| imagen_url | Cover der Folge |
| duracion_segundos | Dauer in Sekunden |
| audio_url | Stabile MP3 des Audios (eigener Player) |
| youtube_url | Video auf YouTube (zum Einbetten per iframe) |
| spotify_url / apple_podcasts_url / ivoox_url | Links zu den Plattformen (falls vorhanden) |
| url_episodio | Seite der Folge auf somosmotor.es (enthält dein ?ref=) |
Struktur der Antwort (Beispiel mit deinem echten Link)
Beispiel wird geladen… So spielst du das Video ab
Das Video liegt auf YouTube (wir liefern keine Videodateien aus). Entnimm die ID aus youtube_url und bette es mit einem iframe ein, genau wie auf unserer Website:
<iframe src="https://www.youtube.com/embed/VIDEO_ID?rel=0" allowfullscreen></iframe> Um nur das Audio abzuspielen, verwende audio_url (MP3) in einem eigenen Player.
Beispiel (curl)
curl -H "x-api-key: DEIN_API_KEY" \
https://somosmotor.es/v2/podcast Fehlercodes
| Code | Bedeutung |
|---|---|
| 401 | Ungültiger oder fehlender API-Schlüssel oder Partner deaktiviert |
| 403 | API-Schlüssel ohne den Scope „podcast“ |
| 429 | Zu viele Anfragen (Limit 60 Anfragen/Min.) |
| 500 | Interner Fehler. Versuche es in ein paar Sekunden erneut |
Ebenfalls verfügbar: öffentlicher RSS-Feed
Wenn du nur den Standard-Audio-Feed möchtest (Spotify/Apple/iVoox), gibt es einen öffentlichen RSS-2.0-Feed, der keinen API-Schlüssel braucht:
GET https://somosmotor.es/podcast/rss.xml
So funktioniert die Zuordnung
- Die Nutzerin oder der Nutzer deiner App tippt bei einem Kurs auf „Anmelden“.
- Deine App öffnet die
url_inscripcionaus dem Feed im Browser des Geräts. - Die Person landet auf
somosmotor.esmit deinem?ref=. Das Cookie wird 30 Tage gespeichert. - Motorleute wickelt die Zahlung ab (Stripe). Dein Rabatt wird automatisch angewendet.
- Der Verkauf wird deinem Code zugeordnet. Die Provision erscheint in deinem Partnerbereich.