İçeriğe Geç
Dokümanlar / Başlarken

Genel Bakış

Bu sayfada

Genel Bakış

Regvion API, Türkiye'nin regülatör otoritelerinden (Resmi Gazete, BDDK, SPK, TCMB vb.) yayımlanan mevzuatı AI ile sınıflandırıp arama, detay inceleme ve abonelik için REST arayüzü sunar. Sunucudan sunucuya entegrasyon için tasarlanmıştır — tarayıcıdan çağırmak üzere değil.

Temel bilgiler

  • Base URL: https://api.regvion.com
  • Sürüm: Tüm uç noktalar /api/v1/ altındadır. V2 yayımlandığında V1 en az 12 ay paralel çalışır.
  • Biçim: JSON istek/yanıt. Content-Type: application/json zorunludur (POST/PUT gövdeleri için).
  • Kimlik doğrulama: Her isteğe X-API-Key başlığı. Detay için API Anahtarı sayfasına bakın.

Yanıt zarfı

Her başarılı yanıt aşağıdaki yapıdadır:

{
  "success": true,
  "data": { /* kaynağa özgü veri */ },
  "pagination": { "page": 1, "pageSize": 20, "totalCount": 42 },
  "meta": {
    "requestId": "req_8a3f9e2c4b8d11ef8a3c0242ac120002",
    "rateLimitRemaining": 847,
    "rateLimitReset": "2026-04-14T10:30:00.0000000Z"
  }
}
  • success — her zaman boolean. false ise error alanı vardır.
  • data — kaynağa özgü gövde. Liste uç noktalarında dizi, detay uç noktalarında nesne.
  • pagination — yalnızca sayfalı uç noktalarda bulunur.
  • meta.requestId — her istek eşsiz, req_ öneki + 32 hex karakter. Destek talebinde mutlaka paylaşın; saniyeler içinde loglarda bulunur.
  • meta.rateLimitRemaining / meta.rateLimitReset — yalnızca oran sınırına tabi uç noktalarda doldurulur. Aynı bilgi X-RateLimit-* HTTP başlıklarında da gelir.

Hata zarfı

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Document not found.",
    "retryAfter": null
  },
  "meta": { "requestId": "req_..." }
}

Detay için Hatalar sayfasına bakın.

Önbellek

Birçok uç nokta Redis'te önbelleklidir (doküman detayı 30 dk, kaynak listesi 10 dk, arama sonuçları 5 dk). Aynı istek ardışık olarak atılırsa ikinci çağrı hızlı döner ve oran sınırına tam sayılır.

Destek