API Certifylize

Automatizza l’emissione dei certificati e integra Certifylize tramite API REST. Ideale per sistemi ERP, MES e QA che vogliono creare, referenziare e collegare certificati direttamente dai workflow.

Nota

Questa pagina è una panoramica tecnica. Endpoint, campi e risposte possono variare in base al piano/setup. Contenuti e validità dei certificati restano responsabilità dell’emittente.

Autenticazione

L’API esterna è protetta tramite una chiave API. Inviarla nell’header x-api-key e trattarla come una password (mai esporla lato client), ruotarla quando necessario e concedere solo permessi minimi.

Header di esempio

x-api-key: YOUR_API_KEY_HERE

Emettere un certificato via API

Questo endpoint crea un certificato. La risposta restituisce ID, URL pubblica di verifica e una checksum SHA-256 come riferimento tecnico per controlli di coerenza (a seconda del setup).

🔍 Request: emettere certificato

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

✅ Response: certificato creato

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

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

🌐 URL di base dell'API pubblica

https://certifylize.com