Partner API

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.

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 catalogProductUid ve Marketplace category grubuyla 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 503 durumundayken entegrasyona hazırlanmak
imzali webhook rehberini public contract'a cikmis olay aileleriyle sinirli okumak

Tipik akış

Kimlik dogrulama

Yayinlanmis bir rotaya bearer istek gonderin; 401, 403 ve auth-authority 503 problem response'larini isleyin.

RFQ Oluşturma

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 503 PARTNER_RFQ_CATALOG_CONTEXT_UNAVAILABLE döner; günlük RFQ hakkı ayrılmaz, kimlik isteği kotası yine tüketilir.

Gelecek quote/order akisi

Estimate ve order adaptörleri kapalı sınır olarak kalır; 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_partner_v2_*` ö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ıç

Etkin RFQ ve kapalı estimate sınırı 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 ve rotaya özel webhook doğrulama rehberi.

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 static yayını güncel /api/v1/marketplace/openapi.json RFQ sözleşmesiyle karşılaştırın; otomatik parity varsaymayın. 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 ön kontrol 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.