API Stravoda

Référence technique de l'API publique.

L'API publique Stravoda est en bêta. Contactez-nous pour obtenir votre clé API : support@stravoda.com

Authentification

Toutes les requêtes sont authentifiées par une clé API transmise dans l'en-tête Authorization : Bearer {API_KEY}.

curl https://stravoda.com/api/v1/students \
  -H "Authorization: Bearer sk_live_xxx"

Endpoints disponibles

MéthodeEndpointDescription
GET/api/v1/studentsListe des élèves
GET/api/v1/students/{id}Fiche élève
GET/api/v1/lessonsPlanning
POST/api/v1/leadsCréer un prospect (widget)

GET /api/v1/students — liste paginée des élèves de votre école.

curl https://stravoda.com/api/v1/students \
  -H "Authorization: Bearer sk_live_xxx"
{
  "data": [
    { "id": "uuid", "firstName": "Jean", "lastName": "Dupont", "neph": "123456789012" }
  ],
  "nextCursor": null
}

POST /api/v1/leads — crée un prospect depuis votre widget de capture.

curl -X POST https://stravoda.com/api/v1/leads \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{ "firstName": "Marie", "phone": "0612345678" }'
{
  "data": { "id": "uuid", "status": "created" }
}

Webhook

Configurez une URL de webhook pour recevoir les événements en temps réel.

Événements disponibles :

  • student.created
  • lesson.completed
  • exam.passed
  • payment.received

Exemple de payload :

{
  "event": "lesson.completed",
  "data": {
    "lessonId": "uuid",
    "studentId": "uuid",
    "completedAt": "2026-06-25T10:00:00Z"
  }
}

Limites

  • 100 requêtes par minute et par clé API.
  • Réponses au format JSON uniquement.

Contact

Pour un accès API ou toute question : support@stravoda.com