Başlangıç Rehberi

Erişim talebinden ilk başarılı Partner API çağrısına kadar olan yolu, yayınlanmış sözleşme ve doğru güvenlik duruşuyla birlikte izlemek için bu rehberi kullanın.

---

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, payload yapısı ve ortam bağlantısını doğrulamak için bir tahmin isteği kullanın:

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
  }'

Bu başarılı olduktan sonra RFQ çalışmasına geçmeden önce sözleşmeyi yeniden kontrol edin. Güncel public RFQ create/list rotaları launch-disabled durumdadır ve canonical L5 catalog/RFQ resolver enabled olana kadar 501 döner.

---

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