API Dokümantasyonu

Beyan.pro REST API

Beyan.pro API ile dilekçe oluşturma, kullanıcı yönetimi ve faturalandırma işlemlerini programatik olarak gerçekleştirin.

Hızlı Başlangıç

# 1. Kullanıcı kaydı

curl -X POST https://api.beyan.pro/api/v1/auth/register \
-H "Content-Type: application/json" \
-d '{"email": "avukat@firma.com", "password": "...", "name": "Av. Mehmet"}'

# 2. Giriş ve token alma

curl -X POST https://api.beyan.pro/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email": "avukat@firma.com", "password": "..."}'

# 3. API kullanımı

curl https://api.beyan.pro/api/v1/dashboard/stats \
-H "Authorization: Bearer <access_token>"

Kimlik Doğrulama

Beyan.pro API, JWT (JSON Web Token) tabanlı kimlik doğrulama kullanır. Başarılı giriş sonrasında bir access token ve refresh token alırsınız.

Access Token

Süre: 15 dakika. Her API isteğinin Authorization header'ında gönderilir.

Refresh Token

Süre: 7 gün. Access token süresi dolduğunda yeni token almak için kullanılır.

Güvenlik: Token'ları güvenli bir şekilde saklayın. Şifreleme için bcrypt (cost 12) kullanılır. İki faktörlü kimlik doğrulama (TOTP) opsiyonel olarak desteklenmektedir.

API Endpoint'leri

MetodEndpointAuth
POST/api/v1/auth/registerHayır
POST/api/v1/auth/loginHayır
POST/api/v1/auth/refreshEvet
GET/api/v1/auth/meEvet
GET/api/v1/tenantEvet
GET/api/v1/tenant/quotaEvet
GET/api/v1/dashboard/statsEvet
GET/api/v1/dashboard/usage-chartEvet
GET/api/petitionsEvet
GET/api/petitions/:idEvet
GET/api/billing/subscriptionEvet
POST/api/billing/checkoutEvet
GET/api/drive/statusEvet
GET/healthHayır

Rate Limitleri

Auth (login/register)5 istek / 15 dakika
API genel100 istek / dakika
Webhook1000 istek / dakika
Dashboard30 istek / dakika

Rate limit aşıldığında HTTP 429 (Too Many Requests) yanıtı döndürülür. Retry-After header'ı beklemeniz gereken süreyi saniye cinsinden belirtir.

Yanıt Formatı

// Başarılı yanıt

{
  "success": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "email": "avukat@firma.com",
    "name": "Av. Mehmet Yilmaz"
  }
}

// Hata yanıtı

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Email adresi gereklidir"
  }
}

Entegrasyon Desteği

API entegrasyonu hakkında sorularınız mı var? Teknik ekibimiz size yardımcı olmaktan memnuniyet duyar.

Teknik Destek