REST API Documentation

Integrasi sistem cerdas VinSight AI dengan Core System FINATRA.

Base URL Server

https://api.vinsight.ai/v1

Seluruh request dan response akan menggunakan format application/json.

Authentication

API VinSight diamankan menggunakan Bearer Token (JWT). Token ini bisa didapatkan melalui dashboard developer FINATRA. Anda harus menyertakan token ini pada setiap header request.

Authorization: Bearer

DNA™ Scoring API

Endpoint utama untuk mengirimkan data UMKM secara masif dari sistem CRM FINATRA, untuk dievaluasi oleh Gemini 1.5 Pro dan dikembalikan sebagai Credit Score.

POST /dna/score/batch

Mengirimkan batch data UMKM (hingga 100 record per request).

Request Body (JSON)

{
  "batch_id": "REQ-2026-08-01",
  "businesses": [
    {
      "business_id": "UMKM-8910",
      "name": "Toko Kelontong Berkah",
      "monthly_revenue": 15000000,
      "years_active": 3,
      "location": { "lat": -6.2115, "lng": 106.8451 },
      "transaction_frequency": "high"
    }
  ]
}
            

Response 200 OK

{
  "status": "success",
  "batch_id": "REQ-2026-08-01",
  "results": [
    {
      "business_id": "UMKM-8910",
      "credit_score": 85,
      "risk_rating": "Low",
      "max_limit": 50000000,
      "ai_insight": "UMKM menunjukkan arus kas sangat sehat di area padat penduduk."
    }
  ]
}
            

Guard™ Alerts API

Endpoint untuk sistem polling atau webhook yang mengambil sinyal Early Warning System (EWS) terkait potensi NPL pada portofolio saat ini.

GET /guard/alerts

Daftar UMKM yang masuk ke dalam Watchlist dalam 24 jam terakhir.

Query Parameters

region_id (opsional) - Filter berdasarkan Area/Cabang.
severity (opsional) - medium atau high.

Response 200 OK

{
  "timestamp": "2026-08-15T08:00:00Z",
  "alerts": [
    {
      "id": "ALT-092",
      "business_id": "UMKM-4421",
      "business_name": "Warung Makan Berkah",
      "severity": "high",
      "trigger": "revenue_drop_30_pct",
      "ai_recommendation": "Jadwalkan kunjungan RO segera untuk negosiasi restrukturisasi ringan."
    }
  ]
}
            