API Certifylize

Automatizo lëshimin e certifikatave dhe integro Certifylize me REST API në proceset e tua. Ideale për ERP, MES dhe QA që duan të krijojnë, referencojnë dhe lidhin certifikata direkt nga workflow ekzistues.

Shënim
Kjo faqe është një përmbledhje teknike. Endpoint-et, fushat dhe përgjigjet mund të ndryshojnë sipas planit/konfigurimit. Përmbajtja dhe vlefshmëria e certifikatës mbeten përgjegjësi e lëshuesit.

Autentikimi

API e jashtme sigurohet me API key. Dërgoje në header-in x-api-key dhe trajtoje si fjalëkalim (mos e ekspozo kurrë në client), rrotulloje kur duhet dhe jep vetëm lejet e nevojshme.

Shembull header

x-api-key: YOUR_API_KEY_HERE

Lësho certifikatë përmes API

Ky endpoint krijon një certifikatë. Përgjigja kthen ID-në e certifikatës, URL publike të verifikimit dhe një checksum SHA-256 si referencë teknike për kontroll konsistence më vonë (sipas konfigurimit).

🔍 Kërkesë: lësho certifikatë

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

✅ Përgjigje: certifikata u krijua

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

{
  "ok": true,
  "id": "cmicbyl6q0007rz5q6rxuofyq",
  "verifyUrl": "https://certifylize.com/sq/verify/cmicbyl6q0007rz5q6rxuofyq",
  "dataHash": "7d9c6f0b0e1c4d..."
}
🌐 URL bazë e API publike
https://certifylize.com