Vérifier plusieurs entrées
const url = 'https://api.arnakoff.com/v1/check/batch';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"items":[{"q":"armen.ltd"},{"q":"FR76 0000","type":"iban"}]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.arnakoff.com/v1/check/batch \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "items": [ { "q": "armen.ltd" }, { "q": "FR76 0000", "type": "iban" } ] }'Vérifie chaque élément comme GET /v1/check. Les résultats suivent l’ordre des éléments ;
un élément invalide donne une erreur à sa place sans faire échouer le lot. Chaque élément,
valide ou non, compte dans le quota de la clé : un lot de n éléments en dépense n. S’il en
reste moins de n, le lot entier est refusé en 429, ne dépense rien, et Retry-After dit
quand n requêtes seront revenues. Le nombre maximal d’éléments est fixé par le serveur,
jamais au-delà du quota de la clé : au-delà, la requête est refusée en 422.
Authorizations
Section intitulée « Authorizations »Request Bodyrequired
Section intitulée « Request Bodyrequired »Les entrées à vérifier.
object
Les entrées, au moins une.
Une entrée à vérifier, comme les paramètres de GET /v1/check.
object
L’entrée telle que l’utilisateur l’a collée.
Type d’une entrée. Une URL est vérifiée comme son domaine (domain).
Examples
Un domaine et une entrée invalide
{ "items": [ { "q": "armen.ltd" }, { "q": "FR76 0000", "type": "iban" } ]}Responses
Section intitulée « Responses »Un résultat par élément, dans l’ordre des éléments.
Un résultat par élément du lot, dans l’ordre des éléments.
object
Les résultats, dans l’ordre des éléments.
Élément vérifié.
object
Rapport de la vérification d’une entrée.
object
L’entrée normalisée qui a été vérifiée, comme le domaine extrait d’une URL. Pour une adresse e-mail, un numéro de téléphone ou un IBAN, c’est une donnée personnelle : la réponse n’est jamais mise en cache.
Type d’une entrée. Une URL est vérifiée comme son domaine (domain).
Heure de la vérification.
« Aucun signal connu dans nos sources » quand signals est vide, null sinon : les
signaux parlent d’eux-mêmes. Ce n’est jamais une garantie.
Les signaux, du plus grave au moins grave.
Un fait sourcé sur l’entrée vérifiée.
object
Identifiant stable de la règle (liste ouverte, voir GET /v1/signals) : un nouveau
code peut apparaître sans changer de version.
Gravité d’un signal, de la plus faible à la plus forte : info (fait neutre),
attention (indice à vérifier avant d’agir), alerte (fait publié par une autorité,
comme une inscription sur une liste noire).
Une phrase factuelle en français qui dit ce qui a été observé.
Conseil facultatif en français, absent quand le signal n’en a pas.
Nom d’une source, tel qu’il est montré aux utilisateurs.
Page publique où le fait se vérifie.
Heure à laquelle le fait a été lu à la source : téléchargement de la liste en service, ou heure de la vérification pour un registre interrogé à la demande.
L’état de chaque source pour cette vérification.
L’état d’une source pour une vérification.
object
Nom d’une source, tel qu’il est montré aux utilisateurs.
Rôle d’une source dans une vérification : ok (consultée), indisponible (pas
consultée : l’absence de signal de cette source ne prouve rien), non_applicable (ne
couvre pas ce type d’entrée).
Élément refusé, sans effet sur les autres.
object
Erreur au format RFC 9457 (application/problem+json).
object
Adresse de la page du site qui documente ce type d’erreur : la documentation des erreurs
suivie du code.
Résumé du type d’erreur, en français, le même pour toutes ses occurrences.
Code de statut HTTP de la réponse.
Explication de cette occurrence, en français. Ne cite jamais une donnée personnelle.
Identifiant de cette occurrence : l’URI tag:arnakoff.com,2026:request: suivie de
l’identifiant de la requête, celui de l’en-tête X-Request-ID de la réponse. À citer
quand on signale un problème. Absent d’une erreur d’un élément de POST /v1/check/batch.
Identifiant stable du type d’erreur (liste ouverte). Chaque code a un exemple
Problem… dans ce contrat.
Examples
Un rapport et une erreur
{ "results": [ { "report": { "input": "armen.ltd", "type": "domain", "checked_at": "2026-11-02T08:25:53Z", "summary": null, "signals": [ { "code": "amf_blacklist", "level": "alerte", "message": "Figure sur la liste noire de l'AMF (catégorie Usurpation) depuis le 08/10/2026.", "source": "AMF", "source_url": "https://www.amf-france.org/fr/espace-epargnants/proteger-son-epargne/listes-noires-et-mises-en-garde", "observed_at": "2026-11-02T08:14:42Z" } ], "sources": [ { "source": "AMF", "status": "ok" }, { "source": "ACPR", "status": "indisponible" }, { "source": "AMF PSAN", "status": "ok" }, { "source": "AMF biens divers", "status": "ok" }, { "source": "ARCEP", "status": "non_applicable" }, { "source": "RDAP", "status": "ok" }, { "source": "SIRENE", "status": "non_applicable" }, { "source": "BODACC", "status": "non_applicable" } ] } }, { "error": { "type": "https://arnakoff.com/docs/erreurs/invalid_input", "title": "Entrée invalide", "status": 422, "detail": "L'entrée n'est pas un IBAN valide.", "code": "invalid_input" } } ]}Quota restant de la politique en cours, selon draft-ietf-httpapi-ratelimit-headers-11 :
r, requêtes encore permises maintenant ; t, secondes avant qu’une requête de plus soit
rendue (pendant ce délai, pas plus de r requêtes), 0 quand le quota est entier.
Example
"key";r=59;t=1Politique de quota, selon draft-ietf-httpapi-ratelimit-headers-11 : q, requêtes
permises par fenêtre ; w, fenêtre en secondes. Le quota entier peut être dépensé d’un
coup, puis il revient au même rythme sur la fenêtre. Politique key sur les routes de
vérification, par clé API (un lot compte pour une requête) ; politique ip sur les routes
sans clé, par adresse du client (préfixe /64 en IPv6) ; politique auth sur les routes de
vérification, par adresse du client, qui compte les clés refusées (mal formées, inconnues
ou révoquées) : une fois ce quota dépensé, les clés envoyées depuis cette adresse ne sont
plus vérifiées et la réponse est 429, même pour une clé valide. La politique auth
n’apparaît que sur ses réponses 429. Sur POST /v1/demo/check, politique demo par
adresse du client et politique demo_global pour tous les clients ensemble, qui
n’apparaît que sur ses réponses 429. Sur POST /v1/keys/request et
POST /v1/keys/redeem, politique key_request par adresse du client. Valeurs de l’exemple
données à titre d’illustration : les quotas dépendent de l’offre.
Example
"key";q=60;w=60Corps de requête qui n’est pas un objet JSON avec une liste items d’au moins un élément.
Erreur au format RFC 9457 (application/problem+json).
object
Adresse de la page du site qui documente ce type d’erreur : la documentation des erreurs
suivie du code.
Résumé du type d’erreur, en français, le même pour toutes ses occurrences.
Code de statut HTTP de la réponse.
Explication de cette occurrence, en français. Ne cite jamais une donnée personnelle.
Identifiant de cette occurrence : l’URI tag:arnakoff.com,2026:request: suivie de
l’identifiant de la requête, celui de l’en-tête X-Request-ID de la réponse. À citer
quand on signale un problème. Absent d’une erreur d’un élément de POST /v1/check/batch.
Identifiant stable du type d’erreur (liste ouverte). Chaque code a un exemple
Problem… dans ce contrat.
Examples
Corps de lot mal formé
{ "type": "https://arnakoff.com/docs/erreurs/invalid_body", "title": "Corps de requête invalide", "status": 400, "detail": "Le corps de la requête doit être un objet JSON contenant une liste items d'au moins un élément.", "instance": "tag:arnakoff.com,2026:request:7NQJ4ZWKX3C5RB2D6HVMTPLE9A", "code": "invalid_body"}Clé API absente, mal formée, inconnue ou révoquée.
Erreur au format RFC 9457 (application/problem+json).
object
Adresse de la page du site qui documente ce type d’erreur : la documentation des erreurs
suivie du code.
Résumé du type d’erreur, en français, le même pour toutes ses occurrences.
Code de statut HTTP de la réponse.
Explication de cette occurrence, en français. Ne cite jamais une donnée personnelle.
Identifiant de cette occurrence : l’URI tag:arnakoff.com,2026:request: suivie de
l’identifiant de la requête, celui de l’en-tête X-Request-ID de la réponse. À citer
quand on signale un problème. Absent d’une erreur d’un élément de POST /v1/check/batch.
Identifiant stable du type d’erreur (liste ouverte). Chaque code a un exemple
Problem… dans ce contrat.
Examples
Clé API manquante
{ "type": "https://arnakoff.com/docs/erreurs/missing_api_key", "title": "Clé API manquante", "status": 401, "detail": "Cette ressource demande une clé API, envoyée dans l'en-tête Authorization avec le schéma Bearer.", "instance": "tag:arnakoff.com,2026:request:7NQJ4ZWKX3C5RB2D6HVMTPLE9A", "code": "missing_api_key"}Clé API invalide
{ "type": "https://arnakoff.com/docs/erreurs/invalid_api_key", "title": "Clé API invalide", "status": 401, "detail": "La clé API est mal formée, inconnue ou révoquée.", "instance": "tag:arnakoff.com,2026:request:7NQJ4ZWKX3C5RB2D6HVMTPLE9A", "code": "invalid_api_key"}Défi d’authentification (RFC 6750, section 3) : Bearer realm="arnakoff" sans clé,
suivi de error="invalid_token" pour une clé refusée.
Example
Bearer realm="arnakoff", error="invalid_token"Corps de requête trop gros.
Erreur au format RFC 9457 (application/problem+json).
object
Adresse de la page du site qui documente ce type d’erreur : la documentation des erreurs
suivie du code.
Résumé du type d’erreur, en français, le même pour toutes ses occurrences.
Code de statut HTTP de la réponse.
Explication de cette occurrence, en français. Ne cite jamais une donnée personnelle.
Identifiant de cette occurrence : l’URI tag:arnakoff.com,2026:request: suivie de
l’identifiant de la requête, celui de l’en-tête X-Request-ID de la réponse. À citer
quand on signale un problème. Absent d’une erreur d’un élément de POST /v1/check/batch.
Identifiant stable du type d’erreur (liste ouverte). Chaque code a un exemple
Problem… dans ce contrat.
Examples
Corps de requête trop gros
{ "type": "https://arnakoff.com/docs/erreurs/content_too_large", "title": "Corps de requête trop gros", "status": 413, "detail": "Le corps de la requête dépasse la taille autorisée.", "instance": "tag:arnakoff.com,2026:request:7NQJ4ZWKX3C5RB2D6HVMTPLE9A", "code": "content_too_large"}Corps de requête qui n’est pas en application/json.
Erreur au format RFC 9457 (application/problem+json).
object
Adresse de la page du site qui documente ce type d’erreur : la documentation des erreurs
suivie du code.
Résumé du type d’erreur, en français, le même pour toutes ses occurrences.
Code de statut HTTP de la réponse.
Explication de cette occurrence, en français. Ne cite jamais une donnée personnelle.
Identifiant de cette occurrence : l’URI tag:arnakoff.com,2026:request: suivie de
l’identifiant de la requête, celui de l’en-tête X-Request-ID de la réponse. À citer
quand on signale un problème. Absent d’une erreur d’un élément de POST /v1/check/batch.
Identifiant stable du type d’erreur (liste ouverte). Chaque code a un exemple
Problem… dans ce contrat.
Examples
Corps de requête qui n'est pas du JSON
{ "type": "https://arnakoff.com/docs/erreurs/unsupported_media_type", "title": "Type de contenu non pris en charge", "status": 415, "detail": "Le corps de la requête doit être en application/json.", "instance": "tag:arnakoff.com,2026:request:7NQJ4ZWKX3C5RB2D6HVMTPLE9A", "code": "unsupported_media_type"}Lot de plus d’éléments que le maximum fixé par le serveur.
Erreur au format RFC 9457 (application/problem+json).
object
Adresse de la page du site qui documente ce type d’erreur : la documentation des erreurs
suivie du code.
Résumé du type d’erreur, en français, le même pour toutes ses occurrences.
Code de statut HTTP de la réponse.
Explication de cette occurrence, en français. Ne cite jamais une donnée personnelle.
Identifiant de cette occurrence : l’URI tag:arnakoff.com,2026:request: suivie de
l’identifiant de la requête, celui de l’en-tête X-Request-ID de la réponse. À citer
quand on signale un problème. Absent d’une erreur d’un élément de POST /v1/check/batch.
Identifiant stable du type d’erreur (liste ouverte). Chaque code a un exemple
Problem… dans ce contrat.
Examples
Lot trop grand
{ "type": "https://arnakoff.com/docs/erreurs/too_many_items", "title": "Trop d'éléments", "status": 422, "detail": "Le lot dépasse le nombre maximal d'éléments autorisé : 50.", "instance": "tag:arnakoff.com,2026:request:7NQJ4ZWKX3C5RB2D6HVMTPLE9A", "code": "too_many_items"}Quota dépassé : celui de la clé (key), de l’adresse (ip), des clés refusées depuis
l’adresse (auth), de l’accès de démonstration (demo, demo_global) ou des demandes de
clé (key_request), nommé dans RateLimit-Policy.
Erreur au format RFC 9457 (application/problem+json).
object
Adresse de la page du site qui documente ce type d’erreur : la documentation des erreurs
suivie du code.
Résumé du type d’erreur, en français, le même pour toutes ses occurrences.
Code de statut HTTP de la réponse.
Explication de cette occurrence, en français. Ne cite jamais une donnée personnelle.
Identifiant de cette occurrence : l’URI tag:arnakoff.com,2026:request: suivie de
l’identifiant de la requête, celui de l’en-tête X-Request-ID de la réponse. À citer
quand on signale un problème. Absent d’une erreur d’un élément de POST /v1/check/batch.
Identifiant stable du type d’erreur (liste ouverte). Chaque code a un exemple
Problem… dans ce contrat.
Examples
Quota dépassé
{ "type": "https://arnakoff.com/docs/erreurs/too_many_requests", "title": "Trop de requêtes", "status": 429, "detail": "Le quota de requêtes est atteint. Réessaie après le délai de l'en-tête Retry-After.", "instance": "tag:arnakoff.com,2026:request:7NQJ4ZWKX3C5RB2D6HVMTPLE9A", "code": "too_many_requests"}Quota restant de la politique en cours, selon draft-ietf-httpapi-ratelimit-headers-11 :
r, requêtes encore permises maintenant ; t, secondes avant qu’une requête de plus soit
rendue (pendant ce délai, pas plus de r requêtes), 0 quand le quota est entier.
Example
"key";r=59;t=1Politique de quota, selon draft-ietf-httpapi-ratelimit-headers-11 : q, requêtes
permises par fenêtre ; w, fenêtre en secondes. Le quota entier peut être dépensé d’un
coup, puis il revient au même rythme sur la fenêtre. Politique key sur les routes de
vérification, par clé API (un lot compte pour une requête) ; politique ip sur les routes
sans clé, par adresse du client (préfixe /64 en IPv6) ; politique auth sur les routes de
vérification, par adresse du client, qui compte les clés refusées (mal formées, inconnues
ou révoquées) : une fois ce quota dépensé, les clés envoyées depuis cette adresse ne sont
plus vérifiées et la réponse est 429, même pour une clé valide. La politique auth
n’apparaît que sur ses réponses 429. Sur POST /v1/demo/check, politique demo par
adresse du client et politique demo_global pour tous les clients ensemble, qui
n’apparaît que sur ses réponses 429. Sur POST /v1/keys/request et
POST /v1/keys/redeem, politique key_request par adresse du client. Valeurs de l’exemple
données à titre d’illustration : les quotas dépendent de l’offre.
Example
"key";q=60;w=60Secondes à attendre avant de réessayer (RFC 9110, section 10.2.3).
Example
30Erreur interne du serveur.
Erreur au format RFC 9457 (application/problem+json).
object
Adresse de la page du site qui documente ce type d’erreur : la documentation des erreurs
suivie du code.
Résumé du type d’erreur, en français, le même pour toutes ses occurrences.
Code de statut HTTP de la réponse.
Explication de cette occurrence, en français. Ne cite jamais une donnée personnelle.
Identifiant de cette occurrence : l’URI tag:arnakoff.com,2026:request: suivie de
l’identifiant de la requête, celui de l’en-tête X-Request-ID de la réponse. À citer
quand on signale un problème. Absent d’une erreur d’un élément de POST /v1/check/batch.
Identifiant stable du type d’erreur (liste ouverte). Chaque code a un exemple
Problem… dans ce contrat.
Examples
Erreur interne
{ "type": "https://arnakoff.com/docs/erreurs/internal_error", "title": "Erreur interne", "status": 500, "detail": "Le serveur a rencontré une erreur. Réessaie plus tard.", "instance": "tag:arnakoff.com,2026:request:7NQJ4ZWKX3C5RB2D6HVMTPLE9A", "code": "internal_error"}La clé API ne peut pas être vérifiée pour le moment.
Erreur au format RFC 9457 (application/problem+json).
object
Adresse de la page du site qui documente ce type d’erreur : la documentation des erreurs
suivie du code.
Résumé du type d’erreur, en français, le même pour toutes ses occurrences.
Code de statut HTTP de la réponse.
Explication de cette occurrence, en français. Ne cite jamais une donnée personnelle.
Identifiant de cette occurrence : l’URI tag:arnakoff.com,2026:request: suivie de
l’identifiant de la requête, celui de l’en-tête X-Request-ID de la réponse. À citer
quand on signale un problème. Absent d’une erreur d’un élément de POST /v1/check/batch.
Identifiant stable du type d’erreur (liste ouverte). Chaque code a un exemple
Problem… dans ce contrat.
Examples
Authentification indisponible
{ "type": "https://arnakoff.com/docs/erreurs/authentication_unavailable", "title": "Authentification indisponible", "status": 503, "detail": "La clé API ne peut pas être vérifiée pour le moment. Réessaie plus tard.", "instance": "tag:arnakoff.com,2026:request:7NQJ4ZWKX3C5RB2D6HVMTPLE9A", "code": "authentication_unavailable"}