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 Ön Kontrol

Metot	Yol	Amaç
POST	/api/v1/preflight	Ayrı ücretli server-work kuyruğu; Partner V2 RFQ işlemi değildir

Kuyruğa alınmış v1 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

• Partner V2 bearer anahtarını yalnız onaylı sunucudan kullanın.
• RFQ komut kimliği ayrıştırılmış gövdeden türetilir; gönderilen Idempotency-Key bu kimliği değiştirmez.
• Tüm kimliği doğrulanan istekler dakika kotasına tabidir; devre dışı estimate/order çağrıları da buna dahildir.
• Günlük RFQ rezervasyonu ancak katalog, L2 ve kanonik şema doğrulamasından sonra yapılır; aynı gövde günlük hakkı ikinci kez tüketmez.
• Webhook aboneliği ile olay tesliminin ayrı yüzeyler olduğunu doğrulayın.

---

İlgili dokümanlar

/api/v1/preflight Partner V2 bearer anahtarını kullanmaz: ayrı sunucu anahtarı ve ücretli server-work yetkisi gerektirir. OpenAPI Explorer kuyruk sözleşmesini açıklar. Teklif tutarı için yayımlanan şema ile mevcut sayısal projeksiyon arasında birim uyumsuzluğu vardır; mutabakat olmadan kuruş dönüşümü veya otomatik finansal işlem yapmayın.