Quotas

Les quotas sont des limites de volume par tenant. Ils sont orthogonaux aux crédits (qui mesurent le coût en € HT) et au rate-limit (qui mesure la fréquence par seconde).

Catalogue (V1)

Clé	Description	Défaut
scraper.jobs.daily	Jobs Scraper créés par jour	10 000
scraper.jobs.concurrent	Jobs en cours d’exécution simultanément	50
extractor.extractions.daily	Extractions créées par jour	10 000
extractor.configs.total	Configs d’extraction stockées	100
iam.identities.total	Identités humaines dans le tenant	50
iam.api-keys.total	Clés API actives dans le tenant	20
webhooks.endpoints.total	URLs webhook enregistrées	30

Les valeurs réelles dépendent de votre plan.

Consulter vos quotas

curl https://orchestrator.extentapi.example/quotas/me \
  -H "x-api-key: ek_live_..."

Réponse (extrait) :

{
  "items": [
    {
      "key": "scraper.jobs.daily",
      "limit": 10000,
      "used": 312,
      "window": "1d",
      "resetAt": "2026-05-22T00:00:00.000Z"
    },
    { "key": "scraper.jobs.concurrent", "limit": 50, "used": 7 }
  ]
}

Demander une augmentation

curl -X POST https://orchestrator.extentapi.example/quotas/me/requests \
  -H "x-api-key: ek_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "quotaKey": "scraper.jobs.daily",
    "requestedLimit": 100000,
    "reason": "Migration d'un pipeline de scraping historique"
  }'

Une demande est revue par l’équipe ExtentAPI. La décision (acceptée / refusée / négociée) est notifiée par email et apparaît dans vos audit logs.

Comportement en cas de dépassement

• Quota journalier : nouvelle requête → 429 quota_exceeded avec un header Retry-After calculé sur la prochaine fenêtre.
• Quota concurrent : nouvelle requête → 429 concurrent_limit_exceeded, à retenter après libération d’un slot.

Quotas ≠ crédits ≠ rate-limit

• Crédits : votre solde en € HT, consommé proportionnellement au coût réel de chaque appel.
• Quotas : volume de ressources autorisé par fenêtre temporelle.
• Rate-limit : fréquence par seconde par clé API.

Vous pouvez dépasser votre rate-limit sans dépasser votre quota, et inversement.