API Dokümantasyonu

LexAnka API'siyle belgelerinizi aktarın, arşivinizde arayın ve yanıt üretin. API erişimi Starter planından itibaren açıktır.

Uç nokta referansı

Hızlı Başlangıç

1. API anahtarı oluşturun

Uygulamada Entegrasyonlar → API Anahtarları ekranından bir anahtar oluşturun ve gerekirse yetki kapsamlarını seçin. Anahtarı bir parola gibi saklayın.

2. Kimlik doğrulama

Her istekte anahtarınızı iki başlıktan biriyle gönderin:

x-api-key: {API_ANAHTARI}Authorization: Bearer {API_ANAHTARI}

Çalışma alanınız anahtardan belirlenir; ayrıca bir kurum ya da çalışma alanı kimliği göndermeniz gerekmez. Bu tür kimlik başlıkları sunucuda yok sayılır.

3. Yetki kapsamları

Anahtara kapsam tanımladıysanız her uç kendi kapsamını ister: documents:read, documents:write, search:read, chat:write (ya da documents:* gibi joker kapsamlar). Kapsam tanımlanmamış anahtar tüm uçlara erişebilir. Eksik kapsamda yanıt 403 INSUFFICIENT_SCOPE olur.

4. Örnek istek

curl -X POST https://dash.lexanka.com/api/v1/search \
  -H "x-api-key: $LEXANKA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "kira sözleşmesinde fesih bildirimi", "k": 5}'

Sınırlar ve hata kodları

  • Her çağrı planınızın aylık API çağrısı sınırına sayılır.
  • Anahtar yoksa ya da geçersizse 401 döner.
  • Deneme süresi bitmiş ya da askıdaki hesapta istekler ödeme gerektiği bilgisiyle reddedilir.

Temel adres: https://dash.lexanka.com/api/v1

Değişiklik günlüğü

  • 28 Ekim 2026: altyapı AB bölgesine (Amsterdam) taşındı; API adresi değişmedi. Webhook çıkış IP'leri değişti.
GET/api/v1/documentsAPI anahtarı gerekir · documents:read

Çalışma alanınızdaki belgeleri en yeniden eskiye listeler

Parametreler:

limit (number)- Sayfa boyutu (varsayılan 50)
offset (number)- Atlanacak kayıt sayısı (varsayılan 0)
search (string)- Başlık veya içerikte geçen ifade

Yanıt:

{
  "success": true,
  "data": "array",
  "pagination": {
    "total": "number",
    "limit": "number",
    "offset": "number",
    "hasMore": "boolean"
  }
}
POST/api/v1/documentsAPI anahtarı gerekir · documents:write

Metin içeriğinden yeni belge oluşturur (JSON). Planınızın aylık belge sınırına sayılır.

Parametreler:

title (string)zorunlu- Belge başlığı
content (string)zorunlu- Belgenin metni
lang (string)- Dil kodu (varsayılan tr)
tags (string[])- Etiketler
source (string)- Kaynak adı (varsayılan api)
uri (string)- Belgenin özgün adresi
lawDomain (string)- Hukuk dalı kodu

Yanıt:

{
  "success": true,
  "data": "object"
}
GET/api/v1/documents/{id}API anahtarı gerekir · documents:read

Tek bir belgeyi döndürür

Yanıt:

{
  "success": true,
  "data": "object"
}
DELETE/api/v1/documents/{id}API anahtarı gerekir · documents:write

Belgeyi siler

Yanıt:

{
  "success": true,
  "message": "string"
}

Webhook'lar

Uygulamadaki Webhook'lar ekranından bir adres tanımlayın; seçtiğiniz olaylar gerçekleştiğinde o adrese imzalı bir istek gönderilir. Gönderilen olaylar: