Authentification
Chaque requête exige une clé API délivrée par le ministère, transmise dans l’en-tête X-Gov-Api-Key. Les clés sont émises par l’équipe Relations gouvernementales de certify après vérification formelle.
curl -H "X-Gov-Api-Key: gov_men_xxxxx" \
https://api.certify.ma/api/gov/v1/verify/{hash}GET/api/gov/v1/verify/{hash}
Vérifie un titre à partir de son empreinte SHA-256. Renvoie le statut, l’établissement et les métadonnées.
Auth: Clé API (en-tête : X-Gov-Api-Key)Débit: 10 000 req/h
{
"verified": true,
"credential": {
"type": "Master",
"field": "Informatique",
"institution": "Université Mohammed V",
"dateConferred": "2026-06-15",
"status": "active"
},
"hash": "sha256:a8f2e1...",
"verifiedAt": "2026-04-11T16:42:12Z"
}GET/api/gov/v1/institution/{code}
Récupère les détails et le statut d’accréditation d’un établissement à partir de son code.
Auth: Clé API (en-tête : X-Gov-Api-Key)Débit: 1 000 req/h
{
"code": "UM5",
"name": "Université Mohammed V",
"city": "Rabat",
"accredited": true,
"totalCredentials": 12847,
"totalVerifications": 98234
}POST/api/gov/v1/batch-verify
Vérifie jusqu’à 500 titres en une requête. Accepte un tableau d’empreintes.
Auth: Clé API (en-tête : X-Gov-Api-Key)Débit: 100 req/h
{
"results": [
{ "hash": "sha256:a8f2...", "verified": true },
{ "hash": "sha256:b3c1...", "verified": false }
],
"total": 2,
"verified": 1,
"failed": 1
}GET/api/gov/v1/statistics
Statistiques nationales agrégées : titres, vérifications, établissements et détection de fraude.
Auth: Clé API (en-tête : X-Gov-Api-Key)Débit: 100 req/h
{
"totalCredentials": 245892,
"totalVerifications": 1234567,
"activeInstitutions": 127,
"fraudsDetected": 342,
"avgVerificationTime": "0.8s"
}GET/api/gov/v1/apostille/{id}/status
Consulte l’état de traitement d’un e-Apostille pour un document donné.
Auth: Clé API (en-tête : X-Gov-Api-Key)Débit: 1 000 req/h
{
"id": "apo_2026_001",
"status": "apostilled",
"destination": "France",
"submittedAt": "2026-04-08",
"completedAt": "2026-04-10",
"downloadUrl": "/api/gov/v1/apostille/apo_2026_001/pdf"
}