API Referansi
NowToPrint Partner API, XJDF/PrintTalk entegrasyon katmani ve ön kontrol yuzeyleri icin tek bakis referansi.
Güncel RFQ oluşturma ve kuruluşa ait tekil RFQ/teklif okuma sözleşmesi /api/v1/marketplace/openapi.json adresinde üretilir. Eski /docs/api/openapi.yaml yayını farklı bir referanstır; iki belgenin eşit olduğunu varsaymayın. Ortam adresini ve etkin yetkileri onboarding sırasında doğrulayın.
NowToPrint birden fazla entegrasyon yuzeyi sunar. Dogru yuzeyi secmek kadar, bu yuzeylerin arkasindaki kanonik veri modelini anlamak da onemlidir.
API yuzeyleri
Partner REST API
Etkin RFQ oluşturma/kuruluşa ait okuma ve kapalı estimate/order sınırları.
XJDF / PrintTalk API
XJDF, PrintTalk ve XJMF birlikte calisan generated standart referansi.
Ön Kontrol 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 | /api/v1/marketplace/openapi.json | Partner REST API |
| XJDF / PrintTalk API | v1 | /docs/api/xjdf-openapi.yaml | XJDF & PrintTalk API |
| Ön Kontrol API | v1 | /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
Partner REST API Reference
Partner Authentication
Webhook Erisim ve Teslimat
XJDF API Rehberi
XJDF Master Data Modeli
Partner API Quickstart
Kimlik doğrulama yüzeye özeldir: public XJDF metadata anahtar istemez; costing kuruluş oturumu ve L4 otoritesi ister; XJMF kayıtlı sender imzası ister. V1 preflight ayrı sunucu bearer anahtarı ve ücretli server-work yetkisi kullanır, Partner V2 anahtarı kullanmaz. Paket sürümünü public /v3 rotası olarak yorumlamayın. Her hatada Retry-After bulunmaz; Partner kota yanıtındaki resetAt alanını işleyin.
Bu makale yardımcı oldu mu?