Information
- License: AGPL-3.0-only
- OpenAPI version:
3.2.1
Vue d’ensemble
Signaux sourcés sur un site, une adresse e-mail, un numéro de téléphone, un IBAN, un SIREN ou un SIRET.
Arnakoff 1.0.0-draft
Section intitulée « Arnakoff 1.0.0-draft »Arnakoff renvoie des signaux sourcés (listes noires de l’AMF et de l’ACPR, SIRENE, BODACC, âge du domaine, numérotation ARCEP…), chacun avec sa source et sa date d’observation.
Aucun signal ne veut dire « Aucun signal connu dans nos sources » : l’absence d’une liste noire ne prouve rien.
Conventions :
- champs JSON en
snake_case, dates et heures en RFC 3339, en UTC ; - erreurs au format RFC 9457 (
application/problem+json) ; - un client ignore les champs qu’il ne connaît pas : un champ facultatif, un code de signal ou un code d’erreur peut être ajouté sans changer de version.
Authentification : les routes de vérification demandent une clé API dans l’en-tête
Authorization: Bearer <clé> (RFC 6750). Les routes de référence (/v1/sources,
/v1/signals) restent publiques.
Accès de démonstration : POST /v1/demo/check vérifie une entrée sans clé, pour le
vérificateur du site seulement. Chaque requête porte un jeton Cloudflare Turnstile, valable une
fois, et le quota est faible. CORS n’autorise que l’origine du site.
Clé gratuite : POST /v1/keys/request envoie à une adresse e-mail un lien de connexion à usage
unique, valable 15 minutes ; la page du site qu’il ouvre échange son jeton contre une clé avec
POST /v1/keys/redeem. Une adresse a une seule clé active : en obtenir une nouvelle révoque
l’ancienne.
Authentication
Section intitulée « Authentication »Clé API envoyée dans l’en-tête Authorization: Bearer <clé> (RFC 6750). Une clé commence
par ark_live_ (production) ou ark_test_ (préproduction), suivi de 30 caractères
aléatoires et d’une somme de contrôle de 6 caractères, tous en base62 : un outil de
détection de secrets la reconnaît sans interroger l’API. Elle n’est affichée qu’une fois, à
sa création ; le serveur n’en garde qu’une empreinte.
Security scheme type: http
Bearer format: ark_live_… ou ark_test_…, 45 caractères