Journal des modifications

L’API suit la politique de version : v1 ne reçoit que des ajouts compatibles. Les changements incompatibles ouvriront /v2, annoncée ici.

Novembre 2026 — clés d’API en libre-service#

Les propriétaires et administrateurs d’un espace créent et révoquent eux-mêmes leurs clés d’API depuis l’espace client (page Clés d’API) : nom, portée read ou read + write, expiration facultative, clé affichée une seule fois. 10 clés actives au plus par espace. Les clés émises par l’équipe Aicscan restent visibles et révocables depuis cette page. Voir Authentification.
Chaque création et révocation est inscrite au journal d’activité de l’espace et notifiée aux propriétaires.
Adresse de contact ajoutée à la documentation : support@aicscan.io.

Première version publique.

API REST (https://aicscan.io/v1)

Authentification par clé d’API (Authorization: Bearer aic_…), portées read et write, expiration et révocation.
Accès réservé aux offres Pro et Business ; limites de l’offre appliquées (plan_limit_reached, channel_kind_not_in_plan, plan_feature_unavailable).
Débit par clé sur une fenêtre d’une seconde, en-têtes RateLimit-* ; quota quotidien par espace, en-têtes Aicscan-Daily-Quota-*.
Pagination par curseur (limit 1 à 100), idempotence des POST (Idempotency-Key, 24 heures), format d’erreur unique avec codes stables.
Ressources : espace (/v1/workspace), adresses, règles (large_transfer, new_counterparty, burst), canaux (webhook, Discord, Slack, email, Telegram, helloMe), invitations de canaux, notifications et renvoi, alertes (/v1/matches), événements, jetons, état du service.
Délai de sécurité d’une heure pour la pause et la suppression d’une règle critique active.
Document OpenAPI 3.1 sur /v1/openapi.yaml.

Webhooks

Requêtes signées en HMAC-SHA256 (X-Signature, X-Timestamp, X-Event-Id), fenêtre anti-rejeu de 5 minutes.
Relances sur 24 heures, désactivation automatique après 24 heures d’échecs, protection SSRF à chaque envoi.

Temps réel

WebSocket wss://aicscan.io/api/ws/alertes authentifié par clé d’API, reprise avec last_id sur 7 jours.

Schémas OpenAPI complétés : type de règle balance_drop (règles créées depuis le tableau de bord), source d’événement balance, liste des étapes de notification (stage).