Guide API

1) Contrat d'intégration

• Ajout: POST /api/partners/contacts-ingest
• Récupération: GET /api/partners/contacts-export
• Auth: Authorization: Bearer PARTNER_TOKEN
• Partner ID: X-Partner-Id: partner_alpha
• Format: application/json pour l'ajout, text/csv pour l'export

Payload requis (ajout)

{
  "email": "contact@entreprise.com",
  "prenom": "Camille",
  "nom": "Durand",
  "societe": "ACME",
  "poste": "Responsable innovation",
  "source": "partner-form-v1",
  "operation_id": "op-q1-2026"
}

2) Exemples cURL

Ajout de données

curl -X POST "https://generative101.club/api/partners/contacts-ingest"   -H "Authorization: Bearer PARTNER_TOKEN"   -H "X-Partner-Id: partner_alpha"   -H "Content-Type: application/json"   -d '{
    "email": "contact@entreprise.com",
    "prenom": "Camille",
    "nom": "Durand",
    "societe": "ACME",
    "poste": "Responsable innovation",
    "source": "partner-form-v1",
    "operation_id": "op-q1-2026"
  }'

Récupération CSV

curl -X GET "https://www.generative101.club/api/partners/contacts-export"   -H "Authorization: Bearer PARTNER_TOKEN"   -H "X-Partner-Id: partner_alpha"   --output "contacts-partner_alpha.csv"

3) Interprétation des résultats

• 200 (dry-run): token valide, endpoint joignable, test technique réussi.
• 202: ingestion acceptée (écriture réelle en ajout).
• 401: token manquant ou invalide.
• 403: partner ID invalide/non autorisé.
• 400: payload non conforme (ajout).
• 429: rate limit atteint.
• 502/503: indisponibilité temporaire de la chaîne de traitement.