API v1

Documentation API

Interrogez les données agricoles d'AgriData IA par programmation : prix, production, textes juridiques et prévisions, en langage naturel via une simple requête HTTP.

L'accès API est réservé au plan Entreprise.

Démarrage rapide

Toutes les requêtes partent de l'URL de base ci-dessous et s'authentifient avec votre clé API dans l'en-tête X-API-Key.

# URL de base
https://agridata-ia.com/api/v1

# Première requête
curl -X POST https://agridata-ia.com/api/v1/chat \
  -H "X-API-Key: sk_live_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"question": "Quel est le prix du maïs au Bénin ?", "lang": "fr"}'

Authentification

Chaque requête doit inclure une clé API valide (préfixe sk_live_) dans l'en-tête X-API-Key.

Vous générez et révoquez vos clés depuis votre espace compte (plan Entreprise requis). Une clé n'est affichée qu'une seule foisà sa création - conservez-la en lieu sûr. Jusqu'à 5 clés actives par compte.

Ne partagez jamais votre clé et ne l'exposez pas côté client (navigateur, application mobile). Traitez-la comme un mot de passe.

Endpoints

POST/api/v1/chat X-API-Key

Pose une question en langage naturel. La réponse est renvoyée en JSON de manière synchrone (pas de streaming).

Corps de la requête

{
  "question": "Quel est le prix du maïs au Bénin ?",  // requis, 1-2000 caractères
  "lang": "fr"                                         // optionnel : "fr" (défaut) ou "en"
}

Réponse

{
  "answer": "Le prix moyen du maïs ...",   // réponse en langage naturel
  "data": [ ... ],                          // données structurées (peut être null)
  "sources": [ ... ],                       // sources citées (peut être null)
  "agent": "prix",                          // agent sollicité : prix | production | juridique
  "tokens_used": 1240,
  "response_time_ms": 1830
}

GET/api/v1/keys Bearer JWT

Liste vos clés API (préfixe, nom, statut, date de dernière utilisation). La clé complète n'est jamais renvoyée. Authentification par jeton de session (compte Entreprise).

POST/api/v1/keys Bearer JWT

Génère une nouvelle clé API. La clé complète est renvoyée une seule fois dans la réponse.

{ "name": "Mon intégration" }   // optionnel, max 100 caractères

DELETE/api/v1/keys/{key_id} Bearer JWT

Révoque une clé API. Elle est désactivée immédiatement et ne peut plus être utilisée.

Quotas

Les appels API consomment le quota quotidien de questions de votre compte. Au-delà, l'API renvoie un code 429.

Plan	Accès API	Questions / jour
Gratuit	Non	-
Pro	Non	-
Entreprise	Oui	200+

Codes d'erreur

Code	Signification
400	Requête invalide (paramètres manquants ou hors limites).
401	Clé API absente ou invalide.
403	Accès API non autorisé (plan Entreprise requis).
404	Ressource introuvable (ex. clé déjà révoquée).
429	Quota quotidien dépassé.
500	Erreur interne du serveur.
503	Service IA temporairement indisponible.

Besoin d'un accès API ?

L'API est incluse dans le plan Entreprise, avec support dédié et tarification sur mesure.

Voir les offres Nous contacter