XJDF API Rehberi

NowToPrint XJDF yuzeyi, CIP4 uyumlu entegrasyonlari modern API disipliniyle sunar. Bu katmanda XJDF 2.2, PrintTalk 2.2 ve harici mesajlasma icin XJMF kullanilir.

---

Temel endpoint'ler

Endpoint	Amac
GET /api/v1/xjdf	Discovery ve yuzey bilgisi
GET /api/v1/xjdf/openapi	OpenAPI 3.1 spesifikasyonu
GET /api/v1/xjdf/capabilities	Desteklenen urun, medya ve finishing yetenekleri
GET /api/v1/xjdf/media-catalog	Kanonik medya katalog gorunumu
GET /api/v1/xjdf/master-data-export	XJDF ResourceSet bazli master-data export
POST /api/v1/xjdf/validate	XJDF dokuman dogrulama

---

Master data export

Export yuzeyi duz bir kagit veya makine listesi donmez. Kanonik modelden turetilen ResourceSet'leri sunar.

Ana aileler:

• paper veya media
• machine veya device
• ink
• lamination
• varnish
• plate
• adhesive
• electricity
• labor

Sik parametreler:

Parametre	Tip	Aciklama
category	string	Virgulle ayrilmis kategori listesi
includeValidation	boolean	Export ile birlikte validation ozeti doner

Ornek:

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://api.nowtoprint.com/api/v1/xjdf/master-data-export?category=paper,ink&includeValidation=true"

Master-data semantigi icin ana referans: XJDF Master Data Modeli

---

Validation

POST /api/v1/xjdf/validate endpoint'i dokumani schema ve temel semantik kurallara gore kontrol eder.

curl -X POST https://api.nowtoprint.com/api/v1/xjdf/validate \
  -H "Content-Type: application/json" \
  -d '{
    "@Version": "2.2",
    "ProductList": {
      "Product": { "@ProductType": "BusinessCard" }
    }
  }'

Validation su sorulari cevaplar:

• schema gecerli mi?
• beklenen vocabulary kullaniliyor mu?
• desteklenmeyen alan veya kategori var mi?

---

XJMF ve webhook siniri

XJMF webhook'lari yalnizca harici vocabulary kabul eder. Ic workflow stage'leri dis Status alani icine yazilmaz.

Beklenen prensip:

• external XJMF status = partnerlar arasi mesajlasma dili
• internal workflow stage = platform ici event dili

Bu ayrim birlikte calisabilirlik icin zorunludur.

---

Guvenlik ve operasyon

• API erisimi API key veya uygun entegrasyonlarda mTLS ile korunur
• webhook ve signal alanlarinda signature dogrulamasi zorunludur
• unsupported veya dogrulanamayan source/compatibility durumlari confidence dusurur
• manual review gereken durumlar kesin quote gibi sunulmaz

---

Sik hata kodlari

HTTP	Kod	Aciklama
400	VALIDATION_ERROR	Gecersiz XJDF yapisi veya semantik sorun
400	INVALID_CATEGORY	Gecersiz master-data kategorisi
401	MISSING_API_KEY	API key saglanmadi
401	INVALID_API_KEY	Gecersiz API key
403	INSUFFICIENT_SCOPE	Yetersiz izin kapsami
429	RATE_LIMIT_EXCEEDED	Hiz limiti asildi

---

Ilgili konular