Endpointler

Bu sayfa güncel Partner API rotalarının okunabilir bir haritasını sunar. Makine tarafından okunabilir doğruluk kaynağı /docs/api/openapi.yaml olmaya devam eder.

---

Base URL

https://api.nowtoprint.com/api/v1

---

Tahmin

Metot	Yol	Amaç
POST	/api/v1/estimate	Auth sonrasi 503 PARTNER_ESTIMATE_CAPABILITY_UNAVAILABLE

---

RFQ'ler

RFQ oluşturma ve okuma canlı ve marketplace-partner-api.v1 sözleşmesi altında dondurulmuş durumda; sözleşme /api/v1/marketplace/openapi.json adresinde yayımlanıyor.

Metot	Yol	Amaç
POST	/api/v1/rfq	Teklif talebi açar (rfq:create)
GET	/api/v1/rfq?id=	Organizasyonunuza ait tek bir RFQ'yu okur (rfq:read)
GET	/api/v1/rfq/{id}/quotes	O RFQ'nun aldığı tedarikçi tekliflerini okur (quotes:read)

Bu sözleşmenin bilinçli olarak yapmadığı üç şey var:

• Serbest metin kategorinizden katalog ürünü türetmez. catalogProductUid zorunlu; yayımlanmış projeksiyonu çözülemediğinde yazma 503 PARTNER_RFQ_CATALOG_CONTEXT_UNAVAILABLE ile reddedilir. Bu, o ürün için bir hazırlık durumudur; kalıcı bir yetenek eksikliği değil. category de zorunludur ve müşterinin seçtiği Marketplace sunum grubunu taşır. Sunucu bu grubu aynı katalog projeksiyonundan çözülen L2 yaprakla doğrular; uyumsuzluğu sessizce yeniden yazmaz.
• RFQ listelemez. ?id= gönderin. Olmayan bir RFQ ile başka bir organizasyona ait bir RFQ aynı 404'ü döner; böylece bir kimliğin varlığı yoklanamaz.
• Teklif kabul etmez, sipariş vermez. Bunlar hesap ve insan onayı gerektirir ve v1'in parçası değildir.

Teklif kabulü ve sipariş rotaları Launch-disabled (HTTP 503) durumunda kalır. Ne /docs/api/openapi.yaml içinde ne de yukarıdaki canlı sözleşmede listelenen bir route'u public client generation için unavailable kabul edin.

---

Teklif ve siparis akisi

Order ve batch kabiliyetleri launch-disabled durumundadır ve fail-closed sınırlar olarak kalır. Auth ve permission kontrolünden sonra PARTNER_ORDER_CAPABILITY_UNAVAILABLE veya PARTNER_BATCH_ORDER_CAPABILITY_UNAVAILABLE kodlu RFC 9457 503 döner; order veya batch kalemi oluşturulmaz, listelenmez ya da denenmez. Bu non-public route'lar burada ilan edilmez.

---

Partner API'den Preflight

Metot	Yol	Amaç
POST	/api/v1/preflight	Ticari taraflı preflight analizi için dosya gönderin

Kuyruğa alınmış v3 doğrulama yüzeyine doğrudan ihtiyacınız varsa /docs/api/preflight-openapi.yaml sözleşmesini kullanın.

---

Webhook'lar

Webhook management ve event delivery her Partner API key için public-current production enablement değildir. /api/v1/webhooks management route'u, webhooks:manage iznine sahip aktif registry key gerektiren private-beta control-plane yüzeyidir; quote/order event delivery ayrıca contract, entitlement ve rollout state'e bağlıdır.

---

Master Data

Master Data data-product'ları internal, pre-live ve private-beta controlled durumdadır. External GA enabled değildir. Public Partner API erişimi şu anda externally enabled Master Data data-product endpoint'leri, partner read'leri veya canonical write authority içermez.

---

İstek rehberi

• public Partner OpenAPI isteklerinde bearer auth kullanın
• yeniden denenebilecek metered read veya write işlemlerinde Idempotency-Key gönderin; eski client'lar için X-Idempotency-Key kabul edilmeye devam eder. Değeri 160 karakter veya daha kısa tutun; daha uzun değerler kesilmez, reddedilir
• canlı RFQ create, transactional günlük kotayı ancak katalog bağlamı ve L2 yaprağı çözüldükten sonra ayırır. Hazır olmayan ürün kota tüketmez; aynı isteğin tekrarı dayanıklı reservation receipt'ini yeniden kullanır. Disabled estimate/order kabiliyetleri kota tüketmez
• webhook'ları yalnızca onaylı event-delivery pilotları için tercih edin; yalnızca key formatına bakarak webhook availability varsaymayın

---

İlgili dokümanlar