API de vérification des certificats
Vérifiez automatiquement tout certificat émis via AlgeriaCertify avec une seule requête GET, sans clé ni inscription. L'API ne renvoie que ce qu'affiche la page publique tkawen.com/verify — ni e-mail, ni téléphone, ni date de naissance. Un certificat révoqué renvoie toujours valid:false.
Point d'accès
Code : 4 à 64 caractères (lettres latines, chiffres et -), insensible à la casse. Le code du certificat (AC-2026-XXXXXX) ou le jeton du lien de vérification imprimé dans le QR sont acceptés.
# curl curl -s https://tkawen.com/api/v1/verify/AC-2026-RTLZEX // JavaScript (CORS ouvert pour GET) const r = await fetch('https://tkawen.com/api/v1/verify/' + encodeURIComponent(code)); const data = await r.json(); if (data.valid) console.log(data.holder_display, data.title);
Réponse
Valide — 200
{
"valid": true,
"status": "valid",
"api_version": "1",
"code": "AC-2026-RTLZEX",
"holder_display": "…",
"title": "…",
"issuer": {
"name": "…",
"org_url": "https://tkawen.com/org/…"
},
"issued_at": "2026-09-30",
"expires_at": null,
"verify_url": "https://tkawen.com/verify?code=…",
"certificate_url": "https://algeriacertify.com/v/…",
"source": "AlgeriaCertify",
"checked_at": "2026-10-04T02:00:00+00:00"
}Révoqué — 200
{
"valid": false,
"status": "revoked",
"api_version": "1",
"code": "AC-2026-XXXXXX",
"verify_url": "https://tkawen.com/verify?code=…",
"source": "AlgeriaCertify",
"checked_at": "…"
}Le nom du titulaire d'un certificat révoqué n'est jamais republié.
Introuvable — 404
{
"valid": false,
"status": "not_found",
"api_version": "1",
"code": "AC-2026-XXXXXX",
"verify_url": "https://tkawen.com/verify?code=…",
"source": "AlgeriaCertify",
"checked_at": "…"
}Un certificat pas encore émis (en revue ou refusé) est traité comme introuvable.
Champs et statuts
| Champ | Description |
|---|---|
valid | true uniquement si le certificat est émis et non révoqué. |
status | valid · revoked · not_found · invalid (format incorrect, HTTP 422) · unavailable (source injoignable, HTTP 503 — réessayez, ne concluez pas « introuvable »). |
holder_display | Nom du titulaire tel qu'affiché sur la page publique de vérification. |
title | Formation ou qualification. |
issuer.name · issuer.org_url | Organisme émetteur et sa page TKAWEN si elle existe (sinon null). |
issued_at · expires_at | Date d'émission et d'expiration (YYYY-MM-DD ou null). |
verify_url | Page de vérification humaine sur tkawen.com — à montrer à l'utilisateur. |
Limites et conditions
| Élément | Valeur |
|---|---|
| Limite de débit | 60 requêtes par minute et par adresse IP — au-delà HTTP 429 avec Retry-After. |
| Cache | Cache-Control: public, max-age=60 (30 s pour « introuvable »). |
| CORS | Access-Control-Allow-Origin: * pour GET. |
| Authentification | Aucune — API publique en lecture seule. |
Conditions : l'API sert à vérifier un certificat précis que son titulaire vous a présenté ou qui figure dans un dossier (recrutement, admission, partenariat). Le scraping massif, l'énumération de codes et la constitution de bases de données à partir des réponses sont interdits. Nous pouvons bloquer toute adresse qui s'y livre. En l'utilisant, vous acceptez les conditions d'utilisation et la politique de confidentialité.
Badge « موثّقة على TKAWEN »
Pour les organismes vérifiés et les formateurs certifiés : un badge SVG à intégrer sur n'importe quel site, qui renvoie vers la page officielle sur TKAWEN. Il n'existe que pour une entité réellement vérifiée — sinon 404. Ajoutez ?theme=dark pour les sites sombres.
<a href="https://tkawen.com/org/{slug}"><img src="https://tkawen.com/badge/org/{slug}.svg" alt="Vérifiée sur TKAWEN" height="48"></a>
<a href="https://tkawen.com/trainers/{code}"><img src="https://tkawen.com/badge/trainer/{code}.svg" alt="Formateur vérifié sur TKAWEN" height="48"></a>
Les gestionnaires d'un organisme vérifié trouvent le code prêt à copier sur la page de leur organisme ; le formateur, sur sa fiche de l'annuaire.
Pour les agents IA
La carte d'agent /.well-known/agent.json décrit cette API et les autres compétences publiques (formations par wilaya, annuaire des formateurs, demande d'académie TKAWEN OS) ; la passerelle MCP expose la vérification via l'outil tkawen_verify.