REST + Webhook v2.1 Beta

FinAsis Entegrasyon API Dokümantasyonu

FinAsis platformundaki finans, uyumluluk ve eğitim modüllerine güvenli şekilde bağlanın. OAuth2 kimlik doğrulama, olay tabanlı webhooklar ve örnek kodlar bu rehberde.

Kimlik Doğrulama API Uç Noktaları Webhook Senaryoları

OAuth 2.0 Client Credentials

Token Alma

Geliştirici portalında oluşturduğunuz istemci kimliği ve gizli anahtar ile erişim token'ı alın. Token süresi varsayılan olarak 1 saattir.

POST /api/oauth/token
Content-Type: application/json

{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_SECRET",
  "grant_type": "client_credentials",
  "scope": "finance.read compliance.read"
}

GET

/api/v1/finance/cashflow

Nakit akışı özetlerini tarih aralığına göre listeler. Banka entegrasyonundan toplanan veriler günlük olarak güncellenir.

Parametreler: start_date, end_date, account_id
Desteklenen format: JSON, CSV
Örnek cevap: toplam giriş/çıkış, net pozisyon

POST

/api/v1/compliance/cases

MASAK uyumluluğu kapsamında şüpheli işlem kaydı oluşturun. Finans ekipleri FinAsis panelinden aksiyona geçer.

Gerekli alanlar: customer_id, risk_score, description
Opsiyonel: supporting_documents[]
Webhook tetiklenir: compliance.case.created

DELETE

/api/v1/lms/enrollments/{id}

FinAsis eğitim modülündeki kurs kayıtlarını siler. KVKK gereklilikleri doğrultusunda talep bazlı işlem yapın.

Yetki gereksinimi: lms.manage
Audit kaydı blockchain kanıtı ile saklanır.
İlgili webhook: lms.enrollment.deleted

Webhook Olayları

FinAsis; finans hareketleri, uyumluluk uyarıları ve eğitim tamamlanma statusu için webhook gönderebilir. HTTPS + HMAC imzalı payload ile doğrulama yapabilirsiniz.

POST https://yourapp.com/webhooks/finasis
Finasis-Signature: t=1731295200,v1=9460f45...

{
  "event": "finance.transaction.created",
  "data": {
    "id": "txn_10492",
    "amount": 18500,
    "currency": "TRY",
    "account_id": "acc_209",
    "booking_date": "2025-11-10",
    "category": "Subscription Revenue"
  }
}

API Anahtar Talep Et Finans Oyun Kitabıyla Devam Et