Intégration par API
Affichez le catalogue de formations et les épisodes du podcast de Cœur Moteur dans votre application. Votre lien d’affilié est inclus automatiquement dans chaque formation.
Vérification de l’accès…
Accès à l’API non activé
L’accès à l’API est réservé aux partenaires avec une intégration directe. Si vous avez une application et souhaitez présenter nos formations, contactez l’équipe.
Contacter l’équipeVotre clé API
Générez ou régénérez votre clé d’accès à l’API. Pour des raisons de sécurité, elle n’est affichée qu’une seule fois.
Enregistrez-la maintenant : pour des raisons de sécurité, elle ne sera plus affichée. Si vous la perdez, générez-en une nouvelle avec ce bouton (la précédente sera invalidée).
Si vous avez déjà une clé active et que vous cliquez sur Générer, la précédente est invalidée immédiatement. Révoquer annule votre clé actuelle sans en créer une autre : elle cesse de fonctionner aussitôt (pour retrouver l’accès, générez-en une nouvelle).
Documentation de l’API
Tout le guide d’intégration (endpoints, authentification, limites, exemples et règles pour bien l’intégrer). Copiez-le et collez-le dans votre IA pour qu’elle l’implémente tout de suite.
Vous ne savez pas de quoi il s’agit ? Petit glossaire
Endpoint : catalogue de formations
Appelez cet endpoint pour obtenir les formations disponibles avec vos prix personnalisés.
Endpoint : catalogue de formations
Appelez cet endpoint pour obtenir les formations disponibles avec vos prix personnalisés.
URL
GET https://somosmotor.es/v1/cursos
Répond en JSON. Cache public de 10 minutes (il est recommandé de respecter le Cache-Control).
Authentification
Envoyez votre clé API de l’une de ces façons :
x-api-key: VOTRE_CLE_API
Authorization: Bearer VOTRE_CLE_API Limites
60
req/min par clé API
10 min
cache public du flux
Structure de la réponse (exemple avec vos données réelles)
Chargement de l’exemple avec vos données… Cet exemple applique votre remise réelle à une formation de démonstration à 180 €, pour que vous voyiez exactement ce que renvoie l’API. url_inscripcion contient déjà votre ?ref=.
Remise et commission ne sont pas la même chose. La remise (celle que vous voyez plus haut dans precio_con_descuento_eur) est ce dont bénéficie votre client en utilisant votre code. Votre commission est ce que vous gagnez sur chaque vente : elle ne circule pas dans ce flux (elle est privée) et vous la consultez dans votre espace Commissions.
Exemple (curl)
curl -H "x-api-key: VOTRE_CLE_API" \
https://somosmotor.es/v1/cursos Codes d’erreur
| Code | Signification |
|---|---|
| 401 | Clé API invalide ou absente, ou partenaire désactivé |
| 403 | Clé API sans le scope « catalogo » |
| 429 | Trop de requêtes (limite de 60 req/min) |
| 500 | Erreur interne. Réessayez dans quelques secondes |
Endpoint : épisodes du podcast
Appelez cet endpoint pour obtenir les épisodes publiés du podcast (audio MP3 + vidéo YouTube).
Endpoint : épisodes du podcast
Appelez cet endpoint pour obtenir les épisodes publiés du podcast (audio MP3 + vidéo YouTube).
URL
GET https://somosmotor.es/v2/podcast
Répond en JSON. Cache public de 10 minutes (il est recommandé de respecter le Cache-Control). Renvoie les épisodes dont l’audio est publié, du plus récent au plus ancien.
Authentification
La même clé API que pour l’endpoint des formations. Envoyez-la de l’une de ces façons :
x-api-key: VOTRE_CLE_API
Authorization: Bearer VOTRE_CLE_API Limites
60
req/min par clé API
10 min
cache public du flux
Champs de chaque épisode
| Champ | Description |
|---|---|
| id / slug | Identifiant unique et slug de l’épisode |
| numero | Numéro de l’épisode |
| titulo / teaser | Titre et court résumé |
| fecha_publicacion | Date (YYYY-MM-DD) |
| invitados | Liste des invités de l’épisode |
| imagen_url | Visuel de l’épisode |
| duracion_segundos | Durée en secondes |
| audio_url | MP3 stable de l’audio (lecteur propre) |
| youtube_url | Vidéo YouTube (à intégrer avec un iframe) |
| spotify_url / apple_podcasts_url / ivoox_url | Liens vers les plateformes (s’ils existent) |
| url_episodio | Page de l’épisode sur somosmotor.es (contient votre ?ref=) |
Structure de la réponse (exemple avec votre lien réel)
Chargement de l’exemple… Comment lire la vidéo
La vidéo est hébergée sur YouTube (nous ne servons pas de fichiers vidéo). Récupérez l’ID dans youtube_url et intégrez-la avec un iframe, comme sur notre site :
<iframe src="https://www.youtube.com/embed/VIDEO_ID?rel=0" allowfullscreen></iframe> Pour lire uniquement l’audio, utilisez audio_url (MP3) dans votre propre lecteur.
Exemple (curl)
curl -H "x-api-key: VOTRE_CLE_API" \
https://somosmotor.es/v2/podcast Codes d’erreur
| Code | Signification |
|---|---|
| 401 | Clé API invalide ou absente, ou partenaire désactivé |
| 403 | Clé API sans le scope « podcast » |
| 429 | Trop de requêtes (limite de 60 req/min) |
| 500 | Erreur interne. Réessayez dans quelques secondes |
Également disponible : RSS public
Si vous voulez seulement le flux audio standard (Spotify/Apple/iVoox), il existe un RSS 2.0 public qui ne demande pas de clé API :
GET https://somosmotor.es/podcast/rss.xml
Comment fonctionne l’attribution
- L’utilisateur de votre application appuie sur « S’inscrire » pour une formation.
- Votre application ouvre la
url_inscripciondu flux dans le navigateur de l’appareil. - L’utilisateur arrive sur
somosmotor.esavec votre?ref=. Le cookie est conservé 30 jours. - Cœur Moteur gère le paiement (Stripe). Votre remise est appliquée automatiquement.
- La vente est attribuée à votre code. La commission apparaît dans votre espace affilié.