Başlangıç Rehberi

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.

Erisimi ve yayinlanmis fail-closed Partner API contract'ini dogrulamak icin bu rehberi kullanin. RFQ oluşturma ve yetkili okuma uygulanır; estimate ve order kabiliyetleri kullanılamaz.

---

1. Onaylı erişim talep edin

Aşağıdaki bilgilerle info@nowtoprint.com adresine başvurun:

• şirket adı ve web sitesi
• entegrasyon kullanım senaryosu
• beklenen hacim veya rollout aşaması
• webhook, XJDF veya private-beta partner onboarding ihtiyacınız olup olmadığı

---

2. Onaylı kimlik bilgisi alın

Onaydan sonra yetkili operatörün kimlik üretme akışıyla Credential V2 secret alın. Partner dashboard güncel olarak raporlama kullanılamıyor ekranıdır; self-servis Developer anahtar üreticisi değildir.

Ortam	Ön ek	Base URL
Onaylı ortam	ntp_partner_v2_*	Onboarding sırasında doğrulanan adres

Önce onaylı test ortamını doğrulayın. Live kimlik bilgileri onaylı akışlar için registry/private-beta kontrolleridir; tek başına public GA trafiği, RFQ oluşturma, quote otomasyonu, order otomasyonu, webhook veya Master Data data-product erişimi açmaz.

---

3. Sözleşmeyi içe aktarın

RFQ istemcisini güncel generated sözleşmeden başlatın:

• /api/v1/marketplace/openapi.json
• Eski allowlist referansı: /docs/api/openapi.yaml

Generated RFQ sözleşmesini Postman, Bruno veya Insomnia'ya aktarın; static referansla farkları uzlaştırın. Estimate/order kabiliyetleri hâlâ kapalıdır.

---

4. İlk isteğinizi gönderin

Auth ve ortam baglantisini dogrulamak icin bir estimate istegi kullanin:

curl -X POST https://api.nowtoprint.com/api/v1/estimate \
  -H "Authorization: Bearer ntp_partner_v2_<issued-key-id>_<secret>" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "flyer",
    "quantity": 1000
  }'

Gecerli auth ve estimate:read ile RFC 9457 PARTNER_ESTIMATE_CAPABILITY_UNAVAILABLE kodlu 503 bekleyin. Body parse edilmez ve estimate uretilmez. Order rotaları ayrı kabiliyete özel 503 yanıtı kullanır. RFQ oluşturma şema, organizasyon kabiliyeti, katalog ve günlük kota kontrollerinden sonra 201 dönebilir; GET ?id= ister, RFQ listesi yoktur.

---

5. Onaylı rollout'a hazırlanın

Herhangi bir onaylı live akıştan önce:

• paylaşılan onboarding anahtarlarını rotasyona alın
• live anahtarı managed secrets içinde saklayın
• webhook doğrulamasını yalnızca webhook-enabled pilotlar için uygulayın
• istek kimliklerini loglayın, dönen reset bilgisini kullanın ve varsa Retry-After başlığına uyun
• enabled olan her write operation için idempotent retry handling test edin
• gerekli RFQ rotalarının /api/v1/marketplace/openapi.json içinde bulunduğunu doğrulayın

---

Sonraki adımlar