Başlangıç Rehberi

Erişim talebinden ilk başarılı Partner API çağrısına kadar olan yolu, genel 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 kullanıma sunma aşaması
• webhook, XJDF veya iş ortağına özel katılım ihtiyacınız olup olmadığı

---

2. Sandbox anahtarı oluşturun

Onaydan sonra, iş ortağı portalı Geliştirici alanında bir sandbox kimlik bilgisi oluşturun.

Ortam	Önek	Base URL
Sandbox	ntp_test_*	https://api.nowtoprint.com/api/v1
Üretim	ntp_live_*	https://api.nowtoprint.com/api/v1

Önce sandbox kullanın. Üretim kimlik bilgileri yalnızca doğrulama ve kullanıma sunma onayından sonra etkinleştirilmelidir.

---

3. Sözleşmeyi import edin

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

• /docs/api/openapi.yaml

Üretim kodu yazmadan önce bu URL'yi Postman, Bruno veya Insomnia'ya import edin. Bu şekilde yükler, örnekler ve beklenen yanıtlar genel sözleşmeyle uyumlu kalır.

---

4. İlk isteğinizi gönderin

Auth, yük 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 oluşturma ve teklif işleme adımlarına geçin.

---

5. Üretime hazırlanın

Canlı trafiğe geçmeden önce:

• paylaşılan katılım anahtarlarını rotasyona alın
• üretim anahtarını yönetilen gizli depolamada saklayın
• webhook doğrulamasını uygulayın
• istek kimliklerini loglayın ve Retry-After başlığına uyun
• yazma işlemlerinde idempotent yeniden deneme yönetimini test edin

---

Sonraki adımlar