Aller au contenu principal

API Quotas et crédits IA

Objectif​

Permettre la consultation et le contrôle des quotas, crédits et coûts IA.

Périmètre​

Quotas par offre, crédits additionnels, suivi consommation, refus en cas de dépassement.

Acteurs/applications consommatrices​

  • DMV.
  • PlayLoop.
  • AssoSuite.
  • Mairie.
  • Backoffice.
  • AI Gateway.

Authentification requise​

À définir. Les quotas et crédits sont des données privées et doivent être authentifiés.

Permissions/RBAC​

  • Utilisateur : consultation de ses quotas.
  • Gestionnaire acteur : quotas de son acteur.
  • Mairie : quotas de sa commune/offre.
  • Admin : supervision agrégée.

Endpoints actuels visibles si confirmés​

Aucun endpoint quotas/crédits IA dédié n’a été confirmé dans les routes inspectées.

Endpoints cibles proposés si utile​

Routes proposées, non définitives :

MéthodeRoute proposéeUsage
GET/api/v1/ai/quotas/meQuotas utilisateur courant.
GET/api/v1/ai/quotas/acteurs/{id}Quotas acteur.
GET/api/v1/ai/usageHistorique ou agrégats d’usage.
POST/api/v1/ai/credits/purchaseAchat de crédits IA si prévu.

Exemple de requête​

GET /api/v1/ai/quotas/me
Authorization: Bearer <token>
X-App-Source: dmv

Exemple de réponse succès​

{
  "data": {
    "monthly_quota": 100,
    "remaining": 42,
    "credits": 10
  }
}

Exemple d’erreur​

{
  "error": "quota_not_available",
  "message": "Aucun quota IA n’est disponible pour ce périmètre."
}

Pagination si applicable​

Applicable à l’historique d’usage.

Rate limiting si applicable​

Recommandé sur consultation répétée et obligatoire sur achat de crédits.

Audit/logs si applicable​

Obligatoire pour achat, décompte, ajustement admin et anomalies coût.

Sécurité​

  • Décompte côté Laravel uniquement.
  • Aucun coût illimité par défaut.
  • Ne pas exposer les prompts complets dans l’historique public.

État actuel vs cible​

SujetÉtat actuelCible
Quotas IADocumentés comme stratégie.API dédiée et décompte centralisé.
Crédits IADocumentés comme business model.Achat/extension contrôlés.

Points à confirmer​

  • Unité de crédit.
  • Quotas par offre.
  • Règles d’échec/retry.
  • Paiement de crédits additionnels.