Gelistirici Merkezi

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 platformunu uygulamalariniza entegre etmek veya platform API'leri uzerine gelistirme yapmak icin teknik kaynaklar.

Hizli baslangic yolu

NowToPrint API'ye yeniyseniz, bu sira ile ilerleyin:

Partner erisimi alin

Sirket adinizi, kullanim senaryonuzu ve tahmini aylik baski hacminizi belirterek info@nowtoprint.com adresine basvurun.

Onaylı kimlik bilgisi alın

Onaydan sonra yetkili operatörden Credential V2 secret alın. Partner dashboard güncel olarak self-servis anahtar üretmez.

Guvenlik: API key'leri tarayici tarafinda kullanmayin. Tum entegrasyonlari server-side calistirin.

Fail-closed baglanti kontrolunu yapin

Estimate isteği geçerli auth ve dakika kotasından sonra kabiliyete özel RFC 9457 503 döndürür. RFQ ise katalog/kuruluş/günlük kota kontrolleriyle 201 oluşturma ve kuruluşa ait okuma destekler.

XJDF master data modelini inceleyin

Harici ERP, MIS veya procurement sisteminizi baglamadan once XJDF Master Data Modeli sayfasini okuyun.

Webhook kurun

Gercek zamanli durum guncellemeleri icin Webhook Erisim ve Teslimat rehberini kullanin.

API yuzeyleri

Yuzey	Auth	Amac
Partner API	API Key	Canlı RFQ create/read ve disabled estimate/order sınırı
XJDF API	Public metadata; costing oturum, XJMF sender yetkisi ayrı	Standart referanslı sözleşme incelemesi
Webhook olaylari	Signature secret	Durum, review ve operasyonel event bildirimi
OpenAPI spec	Yok	Kod uretimi ve client import

Referans dokumanlar

Partner API Quickstart

Erisim alin, test key olusturun ve ilk estimate veya RFQ isteginizi gonderin.

Kimlik Dogrulama

Bearer API key, izin kapsamlari ve guvenli anahtar kullanimi.

Partner API

Canlı RFQ create/read ve fail-closed estimate/order endpoint'leri.

Webhook Erisim ve Teslimat

Signature verification, retry ve event erisim modeli.

XJDF API

XJDF 2.2, PrintTalk 2.2 ve external XJMF mesaj sinirlari.

XJDF Master Data Modeli

Generic, branded, supplier/source, org override ve job snapshot modeli.

OpenAPI Explorer

Yayinlanan spec dosyalari, XJDF onizleme ve import baglantilari.

Sik entegrasyon kaliplari

White-label baski siparisi

Partner API ile yetkili RFQ oluşturun ve tekil RFQ/tekliflerini okuyun. Estimate/order için kabiliyete özel 503 yanıtını işleyin; otomatik fiyat veya sipariş sonucu varsaymayın.

MIS/ERP workflow otomasyonu

XJDF metadata ve doğrulama ile modeli hizalayın; costing, mesajlaşma ve production handoff için ayrı otorite/snapshot sınırlarını doğrulayın.

Master-data senkronizasyonu

Medya, cihaz ve source kataloglarinizi NowToPrint'in bes katmanli modeline gore esleyin. Bu konu icin XJDF Master Data Modeli ana referanstir.

Hizli hata yonetimi

HTTP	Anlam	Aksiyon
`400`	Gecersiz payload veya semantik	Payload'i schema ve vocabulary acisindan kontrol edin
`401`	Yetkisiz	API key veya signature secret kontrolu yapin
`403`	Yetersiz izin	Scope veya partner yetkisini gozden gecirin
`404`	Kaynak bulunamadi	ID ve organization kapsamlarini kontrol edin
`429`	Rate limit	Reset bilgisini kullanın; varsa `Retry-After` başlığına uyun

Tam liste icin Hata Kodlari sayfasina bakin.