Offres et quotas

Les limites de l’API viennent de l’offre de votre espace. Elles s’appliquent de la même façon dans l’espace client et dans l’API : une adresse ajoutée par l’API compte dans la même limite qu’une adresse ajoutée depuis le tableau de bord.

Offres qui comprennent l’API#

	Gratuite	Starter	Pro	Business
Accès à l’API et au temps réel par clé	non	non	oui	oui
Appels par jour (UTC)	—	—	10 000	illimité
Requêtes par seconde et par clé	—	—	25	50
Adresses surveillées	3	25	100	illimité
Règles	3	illimité	illimité	illimité
Canaux	1	5	10	illimité
Types de canaux	Telegram, Discord, helloMe	tous	tous	tous
Chaînes	2	toutes	toutes	toutes
Alerte immédiate (avant confirmation)	non	non	oui	oui
Conservation de l’historique	30 jours	90 jours	365 jours	730 jours

Valeurs en vigueur à la date du journal des modifications. Elles peuvent évoluer : la source de vérité pour votre espace est GET /v1/workspace (champ limits), et les tarifs publics sont sur la page d’accueil (données de GET /api/public/plans). L’offre Business est sur devis : écrivez à support@aicscan.io.

Sur les offres sans API, toute route authentifiée répond :

JSON

{
  "error": {
    "code": "plan_required",
    "message": "API access is not included in the `starter` plan. Upgrade to a plan that includes the API (Pro or Business).",
    "details": { "plan": "starter", "feature": "api" }
  }
}

Lire ses limites et sa consommation#

Shell

curl https://aicscan.io/v1/workspace -H "Authorization: Bearer $AICSCAN_API_KEY"

limits : limites de l’offre (null = illimité). limits.channel_kinds vaut null quand tous les types de canaux sont permis. limits.requests_per_second est le débit appliqué à la clé appelante.
usage : adresses, règles et canaux utilisés, et requests_today, le nombre d’appels servis aujourd’hui (jour UTC).

Limites de ressources#

Quand une création dépasserait une limite, l’API répond 403 plan_limit_reached :

JSON

{
  "error": {
    "code": "plan_limit_reached",
    "message": "Your plan allows 100 addresses; upgrade to add more.",
    "details": { "resource": "addresses", "limit": 100, "current": 100, "plan": "pro" }
  }
}

details.resource vaut addresses, rules, channels ou chains. Les adresses d’une règle sont ajoutées aux adresses surveillées et comptent dans la limite ; une règle ou une adresse sur une chaîne nouvelle pour l’espace compte dans la limite de chaînes.

Autres refus liés à l’offre :

Code	Cause
`channel_kind_not_in_plan`	Type de canal non compris dans l’offre (`details.allowed_kinds`).
`plan_feature_unavailable`	`immediate_alert: true` demandé sur une offre sans alerte immédiate (`details.feature`).

Quota quotidien#

Sur une offre limitée (Pro : 10 000 appels par jour), les appels sont comptés par espace et par jour UTC, toutes clés confondues. Seuls les appels servis comptent : un appel refusé avant d’être traité (clé invalide, débit dépassé, portée insuffisante) ne consomme rien. L’ouverture d’une connexion temps réel compte pour un appel.

Chaque réponse porte :

HTTP

Aicscan-Daily-Quota-Limit: 10000
Aicscan-Daily-Quota-Remaining: 9682

Au-delà du quota, l’API répond 429 daily_quota_exceeded ; Retry-After donne le nombre de secondes jusqu’à minuit UTC, moment où le compteur repart de zéro.

JSON

{
  "error": {
    "code": "daily_quota_exceeded",
    "message": "Daily API quota of the `pro` plan reached (10000 calls per day). It resets at 00:00 UTC.",
    "details": { "limit": 10000, "used": 10000, "plan": "pro", "resets_in_seconds": 5240 }
  }
}

Sur l’offre Business (illimitée), ces en-têtes sont absents. Le débit par seconde s’applique toujours : voir Limites de débit.

Clés d’API et offre#

Sur une offre sans API, la page Clés d’API de l’espace client reste consultable mais la création d’une clé est refusée (plan_required). Après le passage à Pro ou Business, créez votre clé depuis cette page. Les clés existantes continuent d’exister après un passage à une offre sans API, mais leurs appels répondent 403 plan_required. Questions sur les offres : support@aicscan.io.