Développeurs

L'API Mindora, telle qu'elle sera publiée.

Cette page décrit l'interface prévue pour la version 1. Les points d'accès ne sont pas encore ouverts : inscrivez-vous pour recevoir les clés dès l'ouverture.

Rejoindre la liste d'accèsVoir la feuille de route

Aperçu, non disponible en production

Aucune clé n'est délivrée à ce jour. Le contenu ci-dessous sert de référence pour préparer votre intégration.

Principes

REST, JSON, authentification par clé secrète

Requêtes HTTPS uniquement, réponses JSON, pagination par curseur et limites de débit par clé.

Authentification

En-tête Authorization: Bearer sk_live_… La clé est révocable à tout moment depuis la console.

Environnements

Clés de test et de production séparées. Les données de test ne quittent jamais le bac à sable.

Webhooks

Événements signés en HMAC SHA-256 : commande payée, remboursement, abonnement modifié.

Référence

Points d'accès prévus

  • GET/v1/catalogListe les ouvrages publiés, avec prix, catégorie et niveau.
  • GET/v1/catalog/{slug}Détail d'un ouvrage : chapitres, résultats attendus, extraits.
  • POST/v1/checkout-sessionsCrée une session de paiement pour un ouvrage ou une offre groupée.
  • GET/v1/orders/{id}État d'une commande et liens de téléchargement signés.
  • POST/v1/assistant/messagesInterroge l'assistant documentaire et retourne les sources citées.
  • POST/v1/webhooksEnregistre une URL de rappel pour les événements de commande.

Exemple

Lire le catalogue

cURL
curl https://api.webeldorado.com/v1/catalog \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Accept: application/json"

{
  "data": [
    {
      "slug": "systeme-acquisition-clients",
      "title": "Le Système d'acquisition clients",
      "price": 4900,
      "currency": "eur",
      "level": "Intermédiaire"
    }
  ],
  "has_more": false
}