Partner API

Sisteminizi biHesap'a entegre edin

partner-api; X-Integration-Key ile kimlik doğrular, idempotency uygular, outbox üzerinden biHesap'a olay yayınlar. POS, gym, e-ticaret, ERP — kanonik event formatına bir kez yazın, gerisi otomatik.

5 dakikada başla Swagger / ReDoc

12+

REST endpoint

Kanonik event tipi

99.95%

Gateway uptime

90 gün

Audit retention

Akış

Bir partner event'i biHesap'a nasıl ulaşır?

Partner sistemi POST eder

Sisteminiz /api/integrations/v1/* uç noktasına bir event gönderir. X-Integration-Key header ile kimlik doğrulanır.

partner-api validate + idempotency

Payload class-validator ile doğrulanır. (sourceId, externalId) DB-unique + Idempotency-Key Redis cache duplicate'leri engeller.

Outbox + AsyncLocalStorage tenant izolasyonu

Audit + outbox satırı tek transaction'da yazılır. Tenant her query'e otomatik enjekte edilir.

RabbitMQ → biHesap consumer

Worker outbox'ı drain eder, partner.events topic'ine publish eder. biHesap-api event'i invoice / stock movement / cari hareketine çevirir.

Partner sistemi POST eder

Sisteminiz /api/integrations/v1/* uç noktasına bir event gönderir. X-Integration-Key header ile kimlik doğrulanır.

partner-api validate + idempotency

Payload class-validator ile doğrulanır. (sourceId, externalId) DB-unique + Idempotency-Key Redis cache duplicate'leri engeller.

Outbox + AsyncLocalStorage tenant izolasyonu

Audit + outbox satırı tek transaction'da yazılır. Tenant her query'e otomatik enjekte edilir.

RabbitMQ → biHesap consumer

Worker outbox'ı drain eder, partner.events topic'ine publish eder. biHesap-api event'i invoice / stock movement / cari hareketine çevirir.

Modüller

Doküman bölümleri

Hızlı başlangıç

API anahtarını al, ilk request'i at, response'u oku — 5 dakika.

Aç

Kimlik doğrulama

X-Integration-Key, key formatı, rotation, IP allowlist.

Aç

Endpoint kataloğu

Ingestion + Read endpoint'leri. Tam ref Swagger'da.

Aç

Event'ler

partner.sale.recorded, partner.payment.recorded ve diğerleri.

Aç

Hata kodları

Standard error envelope, HTTP status mapping, retry semantiği.

Aç

Rate limit + Idempotency

Rate limit politikası, Idempotency-Key, DLQ, replay.

Aç

Changelog

Event contract versioning, breaking-change politikası.

Aç

Partner olmak için başvur

API anahtarı, sandbox erişim ve teknik destek için ekibimizle görüşün.

Bizimle iletişime geç