Certifylize API

Automatisiere die Ausstellung von Zertifikaten und binde Certifylize über eine REST-API in deine Prozesse ein. Ideal für ERP-, MES- und QA-Systeme, die Zertifikate direkt aus dem Workflow heraus erzeugen, referenzieren und verlinken möchten.

Hinweis

Diese Seite ist eine technische Kurzbeschreibung. Endpunkte, Felder und Antworten können je nach Paket/Setup variieren. Inhalte, Gültigkeiten und Aussagen in Zertifikaten liegen in der Verantwortung des Issuers.

Authentifizierung

Die externe API wird über einen API-Key abgesichert. Der Key wird im Header x-api-key mitgesendet und ist einem Issuer/Konto zugeordnet. Behandle den Key wie ein Passwort (nicht im Client ausliefern), rotiere ihn bei Bedarf und vergib nur die notwendigen Berechtigungen.

Beispiel-Header

x-api-key: YOUR_API_KEY_HERE

Zertifikat perAPI ausstellen

Dieser Endpoint legt ein Zertifikat an. In der Antwort erhältst du die Zertifikats-ID, eine öffentliche Verify-URL sowie eine Prüfsumme (SHA-256) als technische Referenz zur späteren Konsistenzprüfung (je nach Setup).

🔍 Request: Zertifikat ausstellen

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": "kunde@example.com",
  "validUntil": "2027-12-31",
  "metadata": {
    "batch": "B-2025-01",
    "plant": "Werk 1",
    "line": "Linie A",
    "orderNo": "PO-998877"
  }
}

✅ Response: Zertifikat angelegt

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

{
  "ok": true,
  "id": "cmicbyl6q0007rz5q6rxuofyq",
  "verifyUrl": "https://certifylize.com/de/verify/cmicbyl6q0007rz5q6rxuofyq",
  "dataHash": "7d9c6f0b0e1c4d..."
}

🌐 Basis-URL der öffentlichen API

https://certifylize.com