Hızlı Başlangıç
Canli Partner RFQ ve fail-closed capability kontrolleri icin hizli yol.
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.
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_partner_v2_<issued-key-id>_<secret>"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" \
-d '{
"catalogProductUid": "ntp:book:a5:softcover:books",
"title": "Quickstart book request",
"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 ->
Örnek ürün ID’sini ortamınızın yayımlanmış ürün kimliğiyle değiştirin. RFQ tekrar kimliği gövdeden türetilir; yeniden denemeler dakika kotasını tüketir, aynı gövde günlük rezervasyonu tekrar tüketmez.
Bu makale yardımcı oldu mu?