Endpointler
Partner API tahmin, launch-disabled RFQ ve dışarıda bırakılan private-beta yüzeyler için üst düzey endpoint haritası.
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 | Print job pricing signal al |
RFQ'ler
| Metot | Yol | Amaç |
|---|---|---|
POST | /api/v1/rfq | Launch-disabled; auth ve permission kontrolünden sonra 501 döner |
GET | /api/v1/rfq | Launch-disabled; auth ve permission kontrolünden sonra 501 döner |
RFQ detail, supplier quote, quote acceptance ve order rotaları public-current production enablement
değildir. /docs/api/openapi.yaml içinde listelenmeyen route'ları public
client generation için unavailable kabul edin.
Teklif ve siparis akisi
Teklif ve siparis akisi, private-beta evidence, onboarding kontrolleri ve rollout state ilgili partner icin bu operasyonlari acikca enable edene kadar public Partner OpenAPI disinda kalir.
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.
Master Data external-dark
Master Data contract ID'lerini veya API key kayıtlarını live public endpoint olarak yorumlamayın. Route exposure, authorization, audit, quota, onboarding, legal controls, certification controls ve production evidence tamamlanana kadar external partner'lar için runtime-dark kalırlar. Public/partner route'ları canonical L2 truth yazamaz ve private payload alanları olmadan sanitized projection döndürmelidir.
İstek rehberi
- public Partner OpenAPI isteklerinde bearer auth kullanın
- yeniden denenebilecek metered read veya write işlemlerinde
Idempotency-Keygönderin; eski client'lar içinX-Idempotency-Keykabul edilmeye devam eder. Değeri 160 karakter veya daha kısa tutun; daha uzun değerler kesilmez, reddedilir - entitlement-aware limit davranışı için response header'larına güvenin
- 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
Bu makale yardımcı oldu mu?
İlgili makaleler
Last updated on