Partner API Erişim Modeli

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.

Partner API erişimi ayrı bir public self-servis fiyatlandırma basamağı değildir. Erişim kabiliyet yetkisi, rollout state, key registry controls ve daha derin entegrasyonlar için contract-led onboarding ile etkinleştirilir.

Güncel erişim modeli

Erişim durumu	Tipik kullanım	Nasıl etkinleştirilir
Approved integration	Başlangıç entegrasyonları ve sandbox testleri	Erişim talebi / onboarding onayı
Private-beta pilot	Seçili workflow automation ve event delivery	Waitlist / pilot enablement
Enterprise contract	API-heavy entegrasyonlar ve custom limitler	Contract-led rollout

Kimlik kabulü kimlik bilgisi, organizasyon ve scope bazlı dağıtık kota tüketir; usage outbox aynı transaction içindedir. Partner v1 varsayılanı scope başına dakikada 120 istektir. Kapalı estimate/order kabiliyeti 503 dönmeden önce de bu kontrol çalışır. RFQ oluşturma, katalog hazırlığından sonra ayrıca tier bazlı günlük rezervasyon yapar; hazır olmayan katalog bu günlük hakkı tüketmez. Bu açıklama canlı kota/retention kurulumu kanıtı değildir.

Erişimi belirleyen faktörler

güncel organizasyon kabiliyeti ve ticari politika
aktif API capability
key registry state ve scope'lar
rollout state
varsa contract posture

API key'ler

API key'ler caller'ın bilinen ve scoped olduğunu kanıtlar. Tek başına public GA traffic, RFQ create, quote automation, order automation, webhook delivery veya Master Data data-product access açmazlar. Bu capability'ler explicit contract ve rollout enablement gerektirir.

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, entitlement scope'ları, quota, SLA, onboarding controls veya canonical write authority içermez.

Master Data external-dark

Contract-ready, external enabled anlamına gelmez. Runtime auth, audit, quota, onboarding, legal controls, certification controls ve production evidence tamamlanana kadar Master Data partner read yüzeyi dark kalır. Public/partner payload'ları sanitized olmalı; private evidence, cost, margin, payout, supplier source veya rate-card leak etmemelidir.

SSS

Self-servis faturalandırma sayfasından yükseltebilir miyim?

Her zaman değil. Partner API erişimi genellikle generic checkout flow yerine approval, pilot veya contract workflow ile etkinleştirilir.

Partner quota enforce ediliyor mu?

Evet. Kimlik isteği kotası kabiliyet işlenmeden önce uygulanır; RFQ kabulü ayrıca kalıcı günlük rezervasyon kullanır. Kimlik hız sınırı ve günlük RFQ 429 yanıtlarının reset metadata’sını ayrı işleyin. Ticari tier etiketi herkese açık satın alınabilir üyelik paketi değildir.

Kimlik doğrulama consumeCredentialQuota çağırır; sayaç ile credential_v2_usage_outbox aynı Firestore transaction içinde yazılır. Bu dakika kotasının reddi PARTNER_API_RATE_LIMITED olur. Günlük RFQ için ayrı bir reservation port kullanılır; katalog hazır değilse bu günlük rezervasyona ulaşılmaz. Devre dışı estimate/order rotaları kimlik doğrulamayı önce çalıştırdığından dakika kotasını yine tüketir.