E
Easy-FORMA
Démarrer gratuitement

Documentation API

Connectez Easy-FORMA à vos outils métier : Zapier, n8n, Make, Activepieces, ou vos propres scripts.

L'accès à l'API nécessite un forfait incluant la fonctionnalité "Accès API"". Générez vos clés dans Paramètres → API.

Configuration rapide

URL de base de l'API :

https://kvpnppzdogoiaeadbfhb.supabase.co/functions/v1/api

Authentification : ajoutez votre clé API dans le header Authorization :

Authorization: Bearer ef_votre_cle_api

Format d'une requête

Toutes les requêtes sont en POST avec un body JSON contenant action et payload.

{
  "action": "dossiers.list",
  "payload": {
    "limit": 100
  }
}

Ressources et actions

Dossiers

Table : dossiers

  • dossiers.list — lister les dossiers
  • dossiers.get — récupérer un dossier
  • dossiers.create — créer un dossier
  • dossiers.update — mettre à jour un dossier
  • dossiers.delete — supprimer un dossier

Sessions

Table : trainingsessions

  • sessions.list
  • sessions.get
  • sessions.create
  • sessions.update
  • sessions.delete

Financements

Table : financements

  • financements.list
  • financements.get
  • financements.create
  • financements.update
  • financements.delete

Échéances

Table : echeances

  • echeances.list
  • echeances.get
  • echeances.create
  • echeances.update
  • echeances.delete

Programmes

Table : programs

  • programs.list
  • programs.get
  • programs.create
  • programs.update
  • programs.delete

Événements

Table : evenements

  • evenements.list
  • evenements.get
  • evenements.create
  • evenements.update
  • evenements.delete

Exemples

1. Lister les 10 derniers dossiers

curl -X POST https://kvpnppzdogoiaeadbfhb.supabase.co/functions/v1/api \
  -H "Authorization: Bearer ef_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"action":"dossiers.list","payload":{"limit":10}}'

2. Récupérer un dossier par ID

curl -X POST https://kvpnppzdogoiaeadbfhb.supabase.co/functions/v1/api \
  -H "Authorization: Bearer ef_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"action":"dossiers.get","payload":{"id":"UUID_DU_DOSSIER"}}'

3. Créer un dossier

curl -X POST https://kvpnppzdogoiaeadbfhb.supabase.co/functions/v1/api \
  -H "Authorization: Bearer ef_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "dossiers.create",
    "payload": {
      "data": {
        "nom": "Dossier API",
        "dossier_client": "Client Externe",
        "dispositif_id": "UUID_DISPOSITIF",
        "dispositif_nom": "Nom du dispositif",
        "montant_total": 5000,
        "statut": "demande"
      }
    }
  }'

4. Mettre à jour le statut d'un dossier

curl -X POST https://kvpnppzdogoiaeadbfhb.supabase.co/functions/v1/api \
  -H "Authorization: Bearer ef_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{
    "action": "dossiers.update",
    "payload": {
      "id": "UUID_DU_DOSSIER",
      "data": { "statut": "service-fait" }
    }
  }'

Payloads communs

Action Payload attendu
*.list { "limit": 100, "order": ["created_at", false], "filters": { "statut": "demande" } }
*.get { "id": "UUID" }
*.create { "data": { ... } }
*.update { "id": "UUID", "data": { ... } }
*.delete { "id": "UUID" }

Codes d'erreur

  • 401 — Clé API manquante ou invalide.
  • 403 — Clé API révoquée ou forfait ne permettant pas l'API.
  • 400 — Action mal formée ou payload incorrect.
  • 404 — Ressource introuvable.
  • 500 — Erreur serveur.

Aide et support

Pour toute question, générez une nouvelle clé depuis Paramètres → API et consultez les logs de vos appels dans votre outil no-code.