Diplomas.cd API Docs

POST /api/v1/verify-diploma

Vérifie l'authenticité d'un diplôme en fournissant le nom du candidat ou son code EXETAT.

Exemple de requête :

{
  "type": "exetat_code",
  "value": "EX2025CD78901"
}

Réponse réussie :

{
  "success": true,
  "data": {
    "candidate_name": "Jeanne Mukendi",
    "exetat_code": "EX2025CD78901",
    "status": "Admis",
    "level": "Baccalauréat",
    "issued_date": "2025-01-15",
    "verified_at": "2025-04-05T10:30:00Z"
  }
}

Chaque diplôme ou attestation est livré avec un QR Code unique et chiffré. Scannez-le pour obtenir les données vérifiées en temps réel.

POST /api/v1/scan-qrcode

{
  "qrcode_data": "SECURE_TOKEN_JWT_OR_HASH_HERE"
}

Réponse :

{
  "success": true,
  "document_type": "Attestation de Réussite",
  "candidate": "Marc Tshilombo",
  "issue_date": "2025-03-20",
  "valid_until": "2026-03-20",
  "security_hash": "a1b2c3d4e5f6...",
  "is_valid": true,
  "download_url": "https://api.diplomas.cd/download/attestation/xyz123"
}

Envoyez une photo ou scan d’un diplôme. Notre IA extrait les données, les vérifie dans la base officielle, et retourne un rapport de validation.

POST /api/v1/scan-image (multipart/form-data)

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "image=@diploma.jpg" \
  https://api.diplomas.cd/api/v1/scan-image

Réponse :

{
  "success": true,
  "extracted_data": {
    "candidate_name": "Amina Kabuya",
    "document_type": "Diplôme d'État",
    "serial_number": "DIP-CD-2025-5567",
    "issuing_institution": "Ministère de l'EPST"
  },
  "verification_status": "VALID",
  "confidence_score": 0.98,
  "timestamp": "2025-04-05T11:15:22Z"
}

Générez, payez et téléchargez immédiatement des attestations officielles au format PDF sécurisé.

Étape 1 : Créer une commande

POST /api/v1/orders
{
  "document_type": "attestation_reussite",
  "candidate_id": "EX2025CD78901",
  "email": "client@example.com"
}

Réponse :

{
  "order_id": "ORD-2025-ABX789",
  "amount": 15.00,
  "currency": "USD",
  "payment_url": "https://api.diplomas.cd/pay/ORD-2025-ABX789",
  "expires_in": 3600
}

Étape 2 : Télécharger après paiement

GET /api/v1/download/{order_id}
Headers: Authorization: Bearer YOUR_API_KEY

Retourne un PDF signé numériquement avec filigrane de sécurité et QR Code intégré.