Hızlı Başlangıç

Zaten onaylı erişiminiz ve bir sandbox anahtarınız varsa, bu çalışan bir Partner API smoke check için en hızlı yoldur.

---

1. Sandbox anahtarınızı dışa aktarın

export NOWTOPRINT_API_KEY="ntp_test_your_key"

---

2. Estimate sinirini kontrol edin

curl -X POST https://api.nowtoprint.com/api/v1/estimate \
  -H "Authorization: Bearer $NOWTOPRINT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "flyer",
    "quantity": 1000
  }'

---

3. RFQ oluşturun

curl -i -X POST https://api.nowtoprint.com/api/v1/rfq \
  -H "Authorization: Bearer $NOWTOPRINT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: quickstart-rfq-001" \
  -d '{
    "catalogProductUid": "ntp:book:a5:softcover:books",
    "title": "Quickstart flyer order",
    "category": "book",
    "quantity": 1000,
    "deliveryCity": "Istanbul"
  }'

Estimate sınırı 503 PARTNER_ESTIMATE_CAPABILITY_UNAVAILABLE döndürmeye devam eder. Geçerli RFQ 201 ile RFQ kimliği ve takip kodu döndürür. 422 PARTNER_RFQ_INVALID, 429 PARTNER_RFQ_QUOTA_EXCEEDED ve 503 PARTNER_RFQ_CATALOG_CONTEXT_UNAVAILABLE yanıtlarını açıkça işleyin. category, müşterinin seçtiği Marketplace grubudur; sunucu bunu catalogProductUid üzerinden çözdüğü L2 ürünle doğrular ve iki değeri de uydurmaz.

---

4. Otomasyondan önce yayınlanmış sözleşmeyi yeniden kontrol edin

RFQ detail ve organizasyona ait RFQ tekliflerini okuma Partner v1 sözleşmesinde canlıdır. Teklif kabulü, order veya webhook automation'a ancak ilgili operasyon ortamınızın yayımlanmış sözleşmesinde yer aldığında ve registry entitlement'ınız açıkça enabled olduğunda geçin.

---

5. Webhook çalışmasını rollout-gated tutun

İmzalı webhook handling onaylı event-delivery pilotları için gereklidir; ancak quote/order webhook delivery public-current production enablement değildir. Contract, key registry scope'ları ve rollout state doğrulanana kadar webhook kurulumunu private-beta kabul edin.

---

Sonraki: Kimlik Doğrulama ->