Başlangıç Rehberi

Erisimi ve yayinlanmis fail-closed Partner API contract'ini dogrulamak icin bu rehberi kullanin. Henuz basarili estimate, RFQ veya order operasyonu yoktur.

---

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. Sandbox anahtarı oluşturun

Onaydan sonra, partner portalı Developer alanında bir sandbox kimlik bilgisi oluşturun.

Ortam	Ön ek	Base URL
Sandbox	ntp_test_*	https://api.nowtoprint.com/api/v1
Live	ntp_live_*	https://api.nowtoprint.com/api/v1

Önce sandbox kullanı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

Yayınlanmış OpenAPI dosyasından başlayın:

• /docs/api/openapi.yaml

Üretim kodu yazmadan önce bu URL'yi Postman, Bruno veya Insomnia'ya içe aktarın. Böylece payload, örnekler ve beklenen yanıtlar public sözleşmeyle uyumlu kalı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_test_your_key" \
  -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. RFQ ve order rotalari capability'ye ozel kodlarla ayni fail-closed modeli kullanir.

---

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 ve Retry-After başlığına uyun
• enabled olan her write operation için idempotent retry handling test edin
• gerekli rotaların /docs/api/openapi.yaml içinde bulunduğunu doğrulayın

---

Sonraki adımlar