Aller au contenu

Accès gouvernement

API du secteur public

Accès API en lecture seule et sécurisé pour les ministères et agences du gouvernement marocain. Toutes les requêtes sont auditées et journalisées.

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"
}