API Certifylize

Automatisez la création de certificats et intégrez Certifylize via une API REST. Idéal pour les systèmes ERP, MES et QA qui souhaitent créer, référencer et lier des certificats depuis leurs workflows.

Note
Cette page est un aperçu technique. Les endpoints, champs et réponses peuvent varier selon l’offre/la configuration. Le contenu et la validité des certificats restent sous la responsabilité de l’émetteur.

Authentification

L’API externe est sécurisée par une clé API. Envoyez-la dans l’en-tête x-api-key et traitez-la comme un mot de passe (ne jamais l’exposer côté client), rotation si nécessaire et permissions minimales.

En-tête d'exemple

x-api-key: YOUR_API_KEY_HERE

Créer un certificat via API

Ce endpoint crée un certificat. La réponse renvoie l’ID du certificat, une URL publique de vérification et une checksum SHA-256 comme référence technique pour des contrôles de cohérence (selon configuration).

🔍 Requête : créer un certificat

POST /api/external/certificates/issue
Content-Type: application/json
x-api-key: YOUR_API_KEY_HERE

{
  "typeId": 1,
  "productId": "PART-12345",
  "serialNumber": "SN-2025-0001",
  "holderEmail": "client@example.com",
  "validUntil": "2027-12-31",
  "metadata": {
    "batch": "B-2025-01",
    "plant": "Usine 1",
    "line": "Ligne A",
    "orderNo": "PO-998877"
  }
}

✅ Réponse : certificat créé

HTTP/1.1 201 Created
Content-Type: application/json

{
  "ok": true,
  "id": "cmicbyl6q0007rz5q6rxuofyq",
  "verifyUrl": "https://certifylize.com/fr/verify/cmicbyl6q0007rz5q6rxuofyq",
  "dataHash": "7d9c6f0b0e1c4d..."
}
🌐 URL de base de l'API publique
https://certifylize.com