Partner API
Canli Partner RFQ create/read ile fail-closed estimate ve order sinirlari.
Partner API
Master Data external-dark
Master Data data-product API'leri external partnerlar icin runtime-dark kalir. Guncel path sadece internal pre-live/private-beta'dir. Partner API, future external-productization kontrolleri canli olmadan canonical write authority, private evidence, supplier rate, cost, margin veya payout alanlarini acmaz. Bu dry-run first, public-safe sinirdir; external GA onayi olmadan Master Data data-product icin public-current RFQ, quote, order veya webhook vaadi yoktur.
Partner RFQ oluşturma, organizasyona ait tek RFQ'yu okuma ve o RFQ'nun tekliflerini okuma canlıdır. Estimate, teklif kabulü, order ve batch-order kabiliyetleri fail-closed launch sınırı olarak kalır. Her yazımdan önce kimlik, yetki, kota, katalog ve kanonik RFQ doğrulaması uygulanır.
Ne için kullanılır
Partner API'yi şu durumlarda kullanın:
- açık bir
catalogProductUidve Marketplacecategorygrubuyla RFQ oluşturmak - organizasyonunuza ait tek RFQ'yu ve tedarikçi tekliflerini okumak
- auth, permission, quota ve fail-closed response handling'i doğrulamak
- estimate ve order adapter'ları disabled
503durumundayken entegrasyona hazırlanmak - imzali webhook rehberini public contract'a cikmis olay aileleriyle sinirli okumak
Tipik akış
Yayinlanmis bir rotaya bearer istek gonderin; 401, 403 ve auth-authority 503 problem
response'larini isleyin.
catalogProductUid, category, başlık, adet ve teslim şehri gönderin. Hazır ve yetkili ürün
kanonik RFQ pipeline'ına ulaşır; katalog bağlamı hazır değilse kota tüketmeden 503 PARTNER_RFQ_CATALOG_CONTEXT_UNAVAILABLE döner.
Estimate ve order rotalari da disabled sinir olarak yayinlanir; canonical adapter olmadan fiyat veya order kaydi dondurmez.
Erişim durumu
Partner API erişimi yetkilendirme tabanlıdır. Onay, kullanıma sunma durumu ve daha derin entegrasyonlar için sözleşmeye dayalı katılım yoluyla etkinleştirilir.
| Alan | Güncel durum |
|---|---|
| Kimlik Doğrulama | ntp_test_* ve ntp_live_* önekli Bearer API anahtarları |
| Limitler | Yetkilendirme ve kullanıma sunma durumuna göre yönetilir |
| Webhook'lar | Organizasyon ve olay ailesi bazında etkinleştirilir |
| Üretim kullanımı | Onaylı erişim ve üretime hazır sunucu taraflı anahtar yönetimi gerektirir |
Genel kaynaklar
Başlangıç Rehberi
Erişim isteyin, anahtar oluşturun, spec dosyasını import edin ve ilk isteğinizi gönderin.
Hızlı Başlangıç
İlk tahmin ve RFQ akışınız için kısa uygulamalı yol.
Kimlik Doğrulama
Bearer anahtarlari, guvenlik uygulamalari, izinler ve disabled-capability davranisi.
Endpoint'ler
Canli RFQ, disabled estimate/order ve gelecek yuzeyler icin ust duzey endpoint haritasi.
Örnekler
cURL, Node.js, Python ve webhook doğrulama kod parçacıkları.
Webhook'lar
İmzalı teslimat, yeniden deneme yaklaşımı ve yük işleme rehberi.
Kanonik sözleşme
Genel Partner API sözleşmesi /docs/api/openapi.yaml adresinde yayınlanmaktadır.
Bu dosyayı istemci üretimi ve sözleşme incelemesi için makine tarafından okunabilir doğruluk kaynağı olarak kabul edin.
Internal Master Data, admin-only, dark private-beta ve future data-product route'lari public
contract'tan bilerek haric tutulur.
Partner API ne zaman kullanılmamalı
- Kaynak sisteminiz standart tabanlı alışveriş gerektiren bir MIS veya ERP ise XJDF / PrintTalk kullanın.
- Ana hedefiniz teklif ve sipariş otomasyonu yerine kuyruğa alınmış PDF analizi ise OpenAPI Explorer sayfasında açıklanan preflight yüzeyini kullanın.
Sonraki: Başlangıç Rehberi ->
Public contract disi kalan yuzeyler
Internal Master Data, admin-only, dark private-beta ve future data-product route'lari public Partner API OpenAPI contract'i icinde bilerek yayinlanmaz.
Bu makale yardımcı oldu mu?
İlgili makaleler
Last updated on