Documentation · API de vérification

Authentification

L’API n’exige aucune clé à l’heure actuelle. Cette page explique ce qui encadre l’accès aujourd’hui, comment les limites de requêtes se comportent lorsqu’elles sont activées et ce qui changera avec l’arrivée des clés.

Fonctionnement de l’accès aujourd’hui

Le service de données est ouvert : chaque point d’accès répond aux requêtes anonymes GET et POST, sans clé, jeton ni compte. Ce que vous pouvez faire des réponses est déterminé par nos conditions, et non par une clé :

  • Les consultations individuelles, la diligence raisonnable dans un dossier précis, le journalisme et la recherche universitaire sont gratuits en vertu des conditions d’utilisation.
  • La vérification automatisée ou systématique, l’utilisation dans un processus d’affaires et la redistribution nécessitent une licence commerciale.

Nos conditions nous réservent le droit d’appliquer des limites de débit, des plafonds de volume ou des contrôles similaires aux services gratuits, et de refuser l’accès lorsqu’il semble automatisé, systématique ou commercial.

Limites de requêtes

Le service de données comporte une limite de requêtes par adresse que l’exploitant peut activer. Elle est désactivée par défaut et aucun chiffre n’est encore publié. Lorsqu’elle est activée :

  • chaque réponse contient X-RateLimit-Limit (nombre de requêtes autorisées par minute) et X-RateLimit-Remaining ;
  • une requête qui dépasse la limite reçoit un code HTTP 429 avec un en-tête Retry-After (en secondes) et le corps suivant :
{"error": "Too many requests", "limit_per_minute": 60}

Le chiffre de l’exemple est donné à titre indicatif. Gérez 429 en attendant Retry-After secondes avant de réessayer, et regroupez jusqu’à 20 parties dans une même requête de correspondance plutôt que de les envoyer une à une.

À venir : la limite de requêtes qui s’appliquera à l’utilisation anonyme et à l’utilisation sous licence, le cas échéant (aucune limite n’est appliquée actuellement).

Clés d’API

Nous ne délivrons pas encore de clés d’API. Lorsque les clés seront introduites, cette page décrira comment en obtenir une, l’en-tête qui la transporte et la façon d’en effectuer la rotation. D’ici là, n’envoyez aucun identifiant à l’API : elle les ignore.

À venir : délivrance des clés (libre-service ou sur demande), en-tête de requête et format de clé, clés d’essai, clés pour les utilisateurs d’intérêt public et à but non commercial, rotation et révocation. Ne développez pas en vous appuyant sur un format présumé.

Gardez les clés secrètes une fois délivrées. Traitez toute future clé comme un mot de passe : ne l’intégrez ni au code source ni aux pages de navigateur, et chargez-la à partir d’une variable d’environnement ou d’un coffre de secrets.

Exemple : un client prêt pour les clés

Conservez l’adresse de base à un seul endroit afin que l’ajout ultérieur d’identifiants se résume à la modification d’une seule ligne.

import os, requests

BASE = os.environ.get("CROWN_API_BASE", "https://api.crownintelligence.net")
session = requests.Session()
session.headers["User-Agent"] = "my-screening-tool/1.0 ([email protected])"

r = session.post(f"{BASE}/api/match/default", json={"schema": "Company", "properties": {"name": ["Example Trading LLC"]}}, timeout=60)
if r.status_code == 429:
    print("Rate limited; retry after", r.headers.get("Retry-After"), "seconds")
r.raise_for_status()
print(r.json()["responses"]["q1"]["total"])
const BASE = process.env.CROWN_API_BASE ?? "https://api.crownintelligence.net";
const headers = { "Content-Type": "application/json", "User-Agent": "my-screening-tool/1.0 ([email protected])" };

const res = await fetch(`${BASE}/api/match/default`, { method: "POST", headers,
  body: JSON.stringify({ schema: "Company", properties: { name: ["Example Trading LLC"] } }) });
if (res.status === 429) console.log("Rate limited; retry after", res.headers.get("Retry-After"), "seconds");
console.log((await res.json()).responses.q1.total);

Questions sur l’accès : [email protected]. Conditions commerciales : communiquez avec l’équipe des ventes. Les limites et les quotas sont aussi abordés dans la FAQ sur l’API.

Dernière mise à jour : 2026-10-03