API Referansi
NowToPrint Partner API, XJDF/PrintTalk entegrasyon katmani ve preflight yuzeyleri icin tek bakis referansi.
API Referansi
NowToPrint birden fazla entegrasyon yuzeyi sunar. Dogru yuzeyi secmek kadar, bu yuzeylerin arkasindaki kanonik veri modelini anlamak da onemlidir.
API yuzeyleri
Partner REST API
Estimate ve Launch-disabled RFQ hazirlik kontrolleri icin generated endpoint referansi.
XJDF / PrintTalk API
XJDF, PrintTalk ve XJMF birlikte calisan generated standart referansi.
Preflight Motor API
Queue tabanli PDF kalite kontrolu, durum polling ve rapor icin OpenAPI sozlesmesi. Yalnız spesifikasyon — henüz referans sayfası yok.
Kanonik model rehberi
OpenAPI sozlesmeleri tasima formatini tanimlar. Medya, cihaz, supplier/source, organization override ve job snapshot modelinin nasil calistigini anlamak icin ayri master-data rehberini kullanin.
XJDF Master Data Modeli
Generic, branded, supplier/source, org override ve immutable snapshot yapisi.
OpenAPI spesifikasyonlari ve generated referanslar
| API | Surum | Spec | Generated referans |
|---|---|---|---|
| Partner REST API | v1 | /docs/api/openapi.yaml | Partner REST API |
| XJDF / PrintTalk API | v1 | /docs/api/xjdf-openapi.yaml | XJDF & PrintTalk API |
| Preflight API | v3 | /docs/api/preflight-openapi.yaml | Yalnız spesifikasyon — henüz referans sayfası yok |
Source of truth
Transport kontrati icin OpenAPI, master-data semantigi icin ise kanonik XJDF dokumanlari esas
alinmalidir. Sadece allowlist'e alinmis public specler build ve verify sirasinda genel
/docs/api/* URL'lerinde yayinlanir. Internal Master Data sozlesmeleri, admin route'lari, dark
private-beta data-product sozlesmeleri ve gelecek urunlestirme specleri public mirror disinda
kalir.
Partner capability posture
Partner RFQ create, organizasyona ait detail ve quote okumaları canlıdır. Estimate, teklif kabulü, order ve batch-order route'ları Launch-disabled (HTTP 503) kalır. RFQ yazımı auth, kota, katalog bağlamı, L2 ürün veya Marketplace grup doğrulaması başarısızsa fail-closed davranır.
Teklif ve siparis akisi
Order ve batch kabiliyetleri launch-disabled durumundadır ve fail-closed sınırlar olarak kalır.
Auth ve permission kontrolünden sonra PARTNER_ORDER_CAPABILITY_UNAVAILABLE veya
PARTNER_BATCH_ORDER_CAPABILITY_UNAVAILABLE kodlu RFC 9457 503 döner; order veya batch kalemi
oluşturulmaz, listelenmez ya da denenmez. Bu non-public route'lar burada da public Partner
OpenAPI'de de ilan edilmez.
Ilgili rehberler
Bu makale yardımcı oldu mu?
İlgili makaleler
Last updated on