AI destekli hukuki platformu kendi ürününüze entegre edin.
Geliştirici Paneli'ne Git →pk (publishable) client-safe read, sk (secret) server full access. SHA-256 hash storage.
Tenant tier bazında rate limit. X-RateLimit-* response header'ları ile client koordinasyonu.
Standart Problem Details format. `{type, title, status, detail, instance, traceId}`.
Dashboard'dan key oluştur ve revoke et. Revoke sonrası 7 günlük graceful window ile zero-downtime rotasyon desteklenir.
OpenAPI 3.1.0 standardında tüm public endpoint'leri tarayıcıdan test edin.
Terai ve diğer LLM agent'ları için Model Context Protocol (MCP) manifestosu.
OpenAPI 3.1 JSON — Postman/Insomnia import veya SDK generation için. 1 saat ISR cache.
İlk API çağrınızı 5 dakikada yapın — curl + TypeScript örnekleriyle
API key oluşturma, rotasyon, dual-key (pk/sk) kullanım senaryoları
OpenAPI spec'ini indirin, Postman/Insomnia'ya tek yapıştırmayla import edin veya TypeScript tiplerini codegen ile üretin — tüm adresler canlı ve doğrulanmış.
OpenAPI 3.1 spec — 1 saat ISR cache'li, her deploy'da güncel.
curl -o avukatadanis-openapi.json https://avukatadanis.com/api/openapiImport aracında 'Import from URL' → bu adresi yapıştırın.
https://avukatadanis.com/api/openapiopenapi-typescript ile spec'ten tip dosyası üretin — runtime ile drift etmez.
npx openapi-typescript https://avukatadanis.com/api/openapi -o avk-types.d.tsModel Context Protocol manifestosu — LLM agent entegrasyonları için SSoT.
https://avukatadanis.com/.well-known/mcp.jsonTüm public endpoint'leri tarayıcıdan test edin.
https://avukatadanis.com/api-docsavk_sk_* key oluşturun — bu key yalnız MCP tool-entegrasyonunda (aşağıdaki /api/mcp çağrısında) geçerlidir./api/v1/* uçları oturum-çerezi (giriş yapmış tarayıcı) veya UYAP eklenti bearer'ı ile çalışır — avk_pk_/avk_sk_ key kabul etmez (public uçlar zaten anahtar gerektirmez). Detay: /api-docs.RFC 7807 Problem Details JSON objesini inceleyin./api/v1/plansKopyalanabilir cURL ve TypeScript örnekleri, beklenen response önizlemeleri ve her uç için durum rozeti (stable / beta / deprecated / internal). Deprecated uçlar successor yolu ve sunset tarihiyle işaretlenir — durum bilgisi API yüzey envanteri ve versioning kayıtlarından canlı türetilir.
/api/v1/plansPlan kataloğunu döner — public uç, kimlik-doğrulama gerekmez. İlk başarılı isteğiniz bu.
curl https://avukatadanis.com/api/v1/plans \ -H "Accept: application/json"
{
"ok": true,
"plans": [
{
"id": "plan_pro",
"slug": "pro",
"name": "Pro",
"monthly_price": 2999,
"yearly_price": 29990,
"is_active": true,
"is_purchasable": true
}
]
}/api/v1/avukatlarDoğrulanmış avukat dizini. Tarayıcı oturum-çerezi (sb-access-token) ile çağrılır.
curl https://avukatadanis.com/api/v1/avukatlar \ -H "Accept: application/json" \ -H "Cookie: sb-access-token=<session>"
{
"ok": true,
"avukatlar": [
{
"id": "avk_001",
"ad": "Ayşe Yılmaz",
"baro": "İstanbul Barosu",
"baro_no": "12345",
"dogrulandi": true
}
]
}/api/v1/auth/sessionAktif oturumu doğrular — entegrasyonunuzun auth akışını test etmek için ilk durak.
curl https://avukatadanis.com/api/v1/auth/session \ -H "Accept: application/json" \ -H "Cookie: sb-access-token=<session>"
{
"ok": true,
"user": {
"id": "usr_123",
"role": "avukat"
},
"expires_at": "2026-07-12T00:00:00.000Z"
}/api/mcpMCP JSON-RPC ucu — avk_pk_/avk_sk_ API key YALNIZ burada geçerlidir (web uçlarında değil).
curl https://avukatadanis.com/api/mcp \
-H "Authorization: Bearer avk_sk_2b4c7e90..." \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"tools/list","id":1}'{
"jsonrpc": "2.0",
"id": 1,
"result": {
"tools": [
{
"name": "terai_sor",
"description": "Hukuki soruyu Terai'ye iletir"
},
{
"name": "mevzuat_ara",
"description": "Güncel mevzuatta arama yapar"
}
]
}
}/api/hesap/bilgiler/api/v1/profile · sunset: Wed, 01 Jul 2026 00:00:00 GMTLEGACY profil ucu — Deprecation + Link(successor-version) header'ları ile yanıt verir. Yeni entegrasyonlar successor'ı kullanmalı.
curl -i https://avukatadanis.com/api/hesap/bilgiler \ -H "Cookie: sb-access-token=<session>" # Response header'ları: # Deprecation: Wed, 01 Jul 2026 00:00:00 GMT # Link: </api/v1/profile>; rel="successor-version"
{
"ok": true,
"id": "usr_123",
"ad": "Ayşe",
"soyad": "Yılmaz",
"rol": "avukat"
}/api/v1/admin/cost-metricsINTERNAL — yalnız platform-admin oturumu. Dış entegrasyon yüzeyinin parçası değildir; rozeti bunu işaretler.
# internal — dış geliştiricilere kapalı curl https://avukatadanis.com/api/v1/admin/cost-metrics \ -H "Cookie: sb-access-token=<admin-session>"
{
"type": "https://avukatadanis.com/errors/forbidden",
"title": "Forbidden",
"status": 403,
"detail": "Bu uç yalnız platform yöneticilerine açıktır.",
"instance": "/api/v1/admin/cost-metrics",
"traceId": "req_abc123"
}Türkçe ve İngilizce teknik kavramlar
Publishable / Secret Key
Kimlik doğrulama anahtarları. 'pk' (publishable) tarayıcıda, 'sk' (secret) sunucuda kullanılır.
Workspace / Organization
API'yi kullanan avukatlık ofisi veya şirket. Tüm kaynaklar bir tenant'a aittir.
Rate Limit
Belirli bir zaman diliminde yapılabilecek maksimum API isteği sayısı. Aşılırsa 429 döner.
Permission Scope
API anahtarınızın erişim izinleri; iki nokta ile yazılır (ör. forum:read, widget:embed) ve anahtar oluştururken seçilir. Dikkat: loglarda görebileceğiniz tire'li hız-limiti kovalarından (ör. forum-read) AYRIDIR — benzer görünür ama farklı kavramdır (iki nokta = izin, tire = hız limiti).
Webhook
Asenkron olaylar (ör. dava durumu değişimi) gerçekleştiğinde sisteminize yapılan HTTP POST isteği.
Problem Details
API hatalarının standart bir JSON formatında (type, title, detail, status) döndürülmesi.
Model Context Protocol
LLM agent'larının API yeteneklerini anlaması için standartlaştırılmış makine-okunabilir belge.
Hangi API anahtarı profili hangi MCP tool'unu çağırabilir — gerekli yetki kapsamı (permission scope) tool başına tanımlıdır; manifest (/.well-known/mcp.json) ve runtime aynı kaynaktan doğrulanır.
| Tool | Gerekli scope | avk_pk_* (namespaced default) | avk_pk_* (legacy ['read']) | avk_sk_* (namespaced default) | avk_sk_* (legacy ['read','write']) |
|---|---|---|---|---|---|
analyze_legal_situation Hukuki Durum Analizi | ai-chat:use | erişebilir | erişemez | erişebilir | erişemez |
find_lawyer Avukat Bul | read | erişemez | erişebilir | erişemez | erişebilir |
lookup_document Hukuki Doküman Ara | read | erişemez | erişebilir | erişemez | erişebilir |
admin:full ve legacy *wildcard tüm tool'lara erişir; yeni anahtarlara verilmez (dashboard-manuel / yalnız eski kayıtlar).
Tüm hata yanıtları standart Problem Details formatında döner: {type, title, status, detail, instance, traceId}. Katalog, runtime hata kaydıyla birebir aynı kaynaktan türetilir.
5xx hataları traceId + instance: urn:trace:<id>içerir. Destek bildiriminde traceId'yi paylaşın — log'larda birebir eşleşir.
429/503 yanıtlarında Retry-Afterheader'ına uyun; yoksa exponential backoff (1s, 2s, 4s…, jitter'lı). X-RateLimit-*header'ları kalan kotayı gösterir.
Bazı kaynaklarda yetkisiz erişim 403 yerine 404 döner — kaynağın varlığını sızdırmamak için bilinçli tasarımdır.
api-gateway CODE_TO_TYPE'dan türetilir)VALIDATIONhttps://avukatadanis.com/errors/validation-errorİstek gövdesi veya parametreleri şemaya uymuyor. `error.details` alanı hangi alanın bozuk olduğunu gösterir.
Retry: Düzeltmeden tekrarlamayın — aynı istek aynı hatayı verir. Şemayı /api-docs'tan doğrulayın.
INVALID_JSONhttps://avukatadanis.com/errors/invalid-jsonİstek gövdesi geçerli JSON değil (parse hatası).
Retry: Content-Type: application/json gönderdiğinizi ve gövdenin geçerli JSON olduğunu doğrulayın.
PAYMENT_ERRORhttps://avukatadanis.com/errors/payment-errorÖdeme isteği reddedildi (kart, tutar veya sözleşme verisi geçersiz). Ağ geçidi hatası DEĞİLDİR (o UPSTREAM_ERROR).
Retry: Ödeme bilgilerini düzeltmeden tekrarlamayın.
UNAUTHORIZEDhttps://avukatadanis.com/errors/auth-requiredOturum yok, süresi dolmuş veya Authorization header'ı geçersiz.
Retry: Yeniden giriş yapıp yeni oturum-çerezi/key ile tekrarlayın. Sık 401 = key revoke edilmiş olabilir (7 günlük grace sonrası).
PAYMENT_REQUIREDhttps://avukatadanis.com/errors/payment-requiredİşlem için yeterli kredi/bakiye yok veya ödeme gerekiyor.
Retry: Tekrarlamayın — bakiye yüklenmeden aynı sonuç döner. Kredi satın alıp yeniden deneyin.
FORBIDDENhttps://avukatadanis.com/errors/forbiddenKimlik doğrulandı ama bu kaynak/işlem için yetki yok. `reasonCode` extension'ı ayrıntı verir (FUR-6095 taksonomisi).
Retry: Tekrarlama anlamsız — yetki/rol/plan değişmeden aynı sonuç döner.
CSRF_INVALIDhttps://avukatadanis.com/errors/csrf-invalidCSRF token geçersiz veya eksik (state-changing isteklerde).
Retry: Token'ı yeniden alıp (yeni sayfa/oturum) tekrarlayın; cross-origin çağrıda origin header'ını kontrol edin.
CSRF_ERRORhttps://avukatadanis.com/errors/csrf-errorCSRF doğrulaması sırasında iç hata (token üretilemedi/okunamadı).
Retry: Oturumu yenileyip tekrar deneyin; kalıcıysa traceId ile destek.
FEATURE_DISABLEDhttps://avukatadanis.com/errors/feature-disabledÖzellik bayrağı (feature flag) bu tenant/ortam için kapalı.
Retry: Tekrarlama anlamsız — flag açılana kadar aynı sonuç. Panel/durum sayfasından flag durumunu kontrol edin.
PLAN_REQUIREDhttps://avukatadanis.com/errors/plan-requiredBu özellik daha üst bir abonelik planı gerektiriyor (örn. Pro/Enterprise).
Retry: Plan yükseltmeden tekrarlamayın. `error.details` gereken minimum tier'ı gösterebilir.
NOT_FOUNDhttps://avukatadanis.com/errors/not-foundKayıt bulunamadı. Not: bazı kaynaklarda varlık-gizleme (existence-hiding) gereği yetkisiz erişim de 404 döner — bu bilinçlidir.
Retry: Path'i doğrulayın; kaynak gerçekten varsa yetki sorunu olabilir (bkz. 403).
CONFLICThttps://avukatadanis.com/errors/conflictKaynak durum çakışması — örn. aynı kayıt zaten mevcut veya eşzamanlı güncelleme çakıştı.
Retry: Güncel durumu GET ile okuyup isteği ona göre yeniden kurun.
EXPIREDhttps://avukatadanis.com/errors/expiredKaynak veya doğrulama kodu süresi doldu (ör. OTP, tek kullanımlık bağlantı). Kayıt vardı, artık geçerli değil.
Retry: Yeni bir kod/bağlantı talep edip tekrarlayın — eskisi asla geçerli olmayacak.
PAYLOAD_TOO_LARGEhttps://avukatadanis.com/errors/payload-too-largeİstek gövdesi veya yüklenen dosya boyut sınırını aşıyor.
Retry: Tekrarlamayın — dosyayı küçültün veya parçalı yükleme kullanın.
UNPROCESSABLEhttps://avukatadanis.com/errors/unprocessableİstek şema olarak geçerli ama içeriği işlenemedi (ör. bozuk/okunamayan PDF). VALIDATION'dan farkı: gövde doğru, İÇERİK işlenemiyor.
Retry: Aynı içerikle tekrarlamayın — dosyayı/veriyi düzeltip yeniden gönderin.
RATE_LIMITEDhttps://avukatadanis.com/errors/rate-limitedTenant tier bazında rate limit aşıldı. `X-RateLimit-*` header'ları kalan kotayı gösterir.
Retry: Response'un `Retry-After` header'ındaki saniye kadar bekleyin; yoksa exponential backoff (1s, 2s, 4s…, jitter'lı). Sıralı-burst yerine kuyruklu gönderim yapın.
DISPOSABLE_EMAILhttps://avukatadanis.com/errors/disposable-emailTek kullanımlık/geçici e-posta adresi reddedildi (widget OTP kaydı).
Retry: Tekrarlamayın — aynı adres yine reddedilir. Kalıcı bir e-posta adresiyle deneyin.
OTP_REQUIREDhttps://avukatadanis.com/errors/otp-requiredİşlem OTP doğrulaması gerektiriyor; kod alınıp doğrulanmadan tamamlanamaz (sözleşme imzası).
Retry: Tekrarlamayın — önce ?step=send-otp ile kod alın, ?step=verify ile doğrulayın, sonra yineleyin.
SELECTION_REQUIREDhttps://avukatadanis.com/errors/selection-requiredBirden fazla organizasyon üyeliği var ve hangisi adına işlem yapılacağı seçilmemiş. İstek belirsiz, yetkisiz DEĞİL.
Retry: Tekrarlamayın — aktif organizasyonu seçip isteği yineleyin.
CONSENT_OUTDATEDhttps://avukatadanis.com/errors/consent-outdatedKullanıcının onayladığı sözleşme sürümü güncel değil (mesafeli satış metni değişti).
Retry: Tekrarlamayın — yeni metin onaylanmadan aynı sonuç döner. Onay akışını tamamlayıp yineleyin.
MEMBERSHIP_LOSThttps://avukatadanis.com/errors/membership-lostSeçili organizasyondaki üyelik artık aktif değil (çıkarılma/askı).
Retry: Tekrarlamayın — üyelik yeniden kurulmadan aynı sonuç döner.
SUBSCRIPTIONhttps://avukatadanis.com/errors/subscriptionAbonelik aktif değil veya plan yetersiz. PLAN_REQUIRED ile aynı sınıf (403): plan engeli bu taksonomide 403'tür, 402 DEĞİL (402 = kredi/bakiye eksikliği).
Retry: Tekrarlamayın — plan yükseltilene veya abonelik aktifleşene kadar aynı sonuç döner.
WRONG_ORGhttps://avukatadanis.com/errors/wrong-orgKaynak başka bir organizasyona ait; aktif org ile eşleşmiyor.
Retry: Tekrarlamayın — doğru organizasyona geçmeden aynı sonuç döner.
PRECONDITIONhttps://avukatadanis.com/errors/preconditionİşlemin ön koşulu sağlanmamış: kaynağın mevcut durumu bu isteğe izin vermiyor (ör. context satırı yok).
Retry: Tekrarlamayın — önce ön koşulu sağlayın (eksik kaydı oluşturun), sonra yineleyin.
SLOT_TAKENhttps://avukatadanis.com/errors/slot-takenSeçilen randevu saati bu sırada başka bir kayıtla doldu (yarış). CONFLICT'in alan-özgül hâli: hangi çakışma olduğunu söyler.
Retry: Aynı saati tekrarlamayın — takvimi yenileyip müsait başka bir saat seçin.
DEPRECATEDhttps://avukatadanis.com/errors/deprecatedBu API yüzeyi kalıcı olarak kapatıldı; yerine geçen kanonik endpoint mesajda bildirilir.
Retry: Tekrarlamayın — çağrıyı yeni endpoint'e taşıyın. Eski yüzey geri gelmeyecek.
OCR_EMPTYhttps://avukatadanis.com/errors/ocr-emptyBelge işlendi ama metin çıkarılamadı (düşük çözünürlük, eğik/karanlık görüntü). İstek geçerliydi, içerik işlenemedi.
Retry: Aynı dosyayı tekrarlamayın — daha net, düz ve iyi ışıkta çekilmiş bir görüntüyle yeniden yükleyin.
LIMIT_EXCEEDEDhttps://avukatadanis.com/errors/limit-exceededKullanım TAVANINA ulaşıldı (ör. aylık dönüşüm tavanı). Hız limitinden FARKLI: pencere dolunca değil, tavan yenilenince açılır.
Retry: Kısa aralıkla tekrarlamak fayda etmez — tavan yenilenene kadar aynı sonuç döner.
OTP_SEND_FAILEDhttps://avukatadanis.com/errors/otp-send-failedDoğrulama kodu gönderilemedi — tipik sebep art arda istek (SMS/e-posta gönderim limiti).
Retry: Bekleyin; hemen tekrar denemek yeni bir kod göndermez. Retry-After varsa ona uyun.
SELF_APPROVE_FORBIDDENhttps://avukatadanis.com/errors/self-approve-forbiddenKritik bir değişikliği talep eden kullanıcı kendi talebini onaylayamaz (dual-approval kısıtı) — farklı bir yetkili onaylamalı.
Retry: Aynı kullanıcıyla tekrarlamayın — başka bir yetkili kullanıcı onaylamalı.
NO_PREVIOUS_STATEhttps://avukatadanis.com/errors/no-previous-stateGeri alınacak (rollback) önceki bir kayıt bulunamadı — bu kaynak için henüz yeterli geçmiş yok.
Retry: Tekrarlamayın — rollback için önce en az bir önceki uygulanmış durum gerekir.
SERVER_ERRORhttps://avukatadanis.com/errors/internal-errorSunucu tarafında beklenmeyen hata. Response `traceId` + `instance: urn:trace:<id>` içerir — destek bildiriminde traceId'yi mutlaka paylaşın.
Retry: İdempotent isteklerde (GET/PUT) backoff ile tekrarlanabilir; POST için önce işlemin gerçekleşip gerçekleşmediğini doğrulayın. Kalıcı 500 = status sayfası + traceId ile destek.
DB_ERRORhttps://avukatadanis.com/errors/db-errorVeritabanı işlemi başarısız (okuma/yazma). En sık kullanılan sunucu-tarafı hata kodu — `traceId` ile loglardan izlenebilir.
Retry: Idempotent isteklerde üstel geri çekilmeyle (backoff) tekrar deneyin. Yazma işlemlerinde önce kaydın oluşup oluşmadığını doğrulayın.
CONFIG_ERRORhttps://avukatadanis.com/errors/config-errorSunucu yapılandırması eksik veya geçersiz (env değişkeni, servis anahtarı). İstemci kaynaklı değildir.
Retry: Tekrarlamayın — yapılandırma düzeltilmeden aynı sonuç döner. Durum devam ederse destek ile iletişime geçin.
UPSTREAM_ERRORhttps://avukatadanis.com/errors/upstream-errorDış bağımlılık hata döndürdü (AI sağlayıcı, ödeme ağ geçidi, SMS). İstek bize ulaştı ama zincirin ilerisinde koptu.
Retry: Üstel geri çekilmeyle tekrar deneyin. Israrla tekrarlıyorsa sağlayıcı tarafında kesinti olabilir.
SERVICE_UNAVAILABLEhttps://avukatadanis.com/errors/service-unavailableBağımlı servis geçici olarak kullanılamıyor (yoğunluk, bakım, dış-servis kesintisi).
Retry: Exponential backoff ile tekrarlayın; `Retry-After` header'ı varsa ona uyun. Kalıcı 503 = status sayfasını kontrol edin.
SUBSCRIPTION_CHECK_FAILEDhttps://avukatadanis.com/errors/subscription-check-failedAbonelik/plan doğrulaması teknik nedenle yapılamadı (plan-yetersizliği DEĞİL — o PLAN_REQUIRED'dır).
Retry: Geçici durum — backoff ile tekrarlayın. Kalıcıysa traceId ile destek.
REPLAY_FAILEDhttps://avukatadanis.com/errors/replay-failedOlay yeniden oynatma (admin/inngest replay) sırasında sunucu hatası.
Retry: Tekrar deneyebilirsiniz. Israrla tekrarlıyorsa olay kaydı bozuk olabilir — log inceleyin.
NOT_IMPLEMENTEDhttps://avukatadanis.com/errors/not-implementedEndpoint mevcut ama bu işlev henüz uygulanmadı (geçiş dönemi).
Retry: Tekrarlamayın — sunucu tarafında uygulanana kadar aynı sonuç döner.
PAYMENT_INIT_FAILEDhttps://avukatadanis.com/errors/payment-init-failedÖdeme başlatma isteği sağlayıcıya (iyzico) ulaştı ve sağlayıcı hata döndürdü. Ödeme ALINMADI.
Retry: Üstel geri çekilmeyle tekrar deneyebilirsiniz — tahsilat yapılmadığı için çift çekim riski yoktur.
TERAI_FAILEDhttps://avukatadanis.com/errors/terai-failedTerai (AI) sağlayıcısı yanıt üretemedi — zincirin ilerisinde koptu.
Retry: Üstel geri çekilmeyle tekrar deneyin. Israr ederse sağlayıcı tarafında kesinti olabilir.
AUDIT_WRITE_FAILEDhttps://avukatadanis.com/errors/audit-write-failedDenetim kaydı yazılamadı ve FAIL-CLOSED gereği işlem UYGULANMADI (KVKK/TTK izlenebilirlik). Veri tutarsızlığı oluşmaz.
Retry: Tekrar deneyin — geçicidir. İşlem uygulanmadığı için yeniden denemek güvenlidir.
QUOTA_UNAVAILABLEhttps://avukatadanis.com/errors/quota-unavailableDepolama kotası doğrulanamadı: hak var mı yok mu BİLİNMİYOR, fail-closed reddedildi. Kota DOLU demek DEĞİL.
Retry: Birkaç saniye sonra tekrar deneyin — kota servisi toparlayınca istek geçer.
VIDEO_UNAVAILABLEhttps://avukatadanis.com/errors/video-unavailableGörüntülü görüşme odası oluşturulamadı (sağlayıcı geçici olarak kullanılamıyor).
Retry: Birkaç dakika sonra tekrar deneyin.
OLAY_DEFTERI_EKSIKhttps://avukatadanis.com/errors/olay-defteri-eksikOlay defteri EKSİKSİZ getirilemedi: kaynakların bir kısmı okunamadı. Kayıt YOK demek DEĞİL — eksik listeyi tam sanmamak için istek fail-closed reddedildi.
Retry: Birkaç saniye sonra tekrar deneyin — erişilemeyen kaynak toparlanınca defter tam gelir.
{
"type": "https://avukatadanis.com/errors/rate-limited",
"title": "Too Many Requests",
"status": 429,
"detail": "Çok fazla istek gönderdiniz. 60 saniye sonra tekrar deneyebilirsiniz.",
"ok": false,
"error": {
"code": "RATE_LIMITED",
"message": "Çok fazla istek gönderdiniz."
},
"traceId": "req_7f3a9c21",
"instance": "urn:trace:req_7f3a9c21"
}Content-Type: application/problem+json · Header: Retry-After: 60
Platformda üç ayrı, birbirinden bağımsız kimlik-modeli vardır — hangi uç hangisini kabul ettiğini karıştırmayın:
avk_pk_* / avk_sk_*): yalnız /api/mcp tool-entegrasyonunda geçerlidir. Publishable (avk_pk_*) client-safe read-only; Secret (avk_sk_*) server-side full access, asla client bundle'a koyulmamalı./api/v1/* web-uçlarının varsayılan (ve tek) kimlik modeli — giriş yapmış kullanıcı çerezi (sb-access-token). avk_* key bu uçlarda İŞLEMEZ.uxt_*): yalnız eklenti-entegre uçlarda (örn. UYAP içe-aktarma) oturum-çerezine alternatif olarak kabul edilir.Legacy (versiyonsuz) endpoint'lerin sunset takvimi, deprecation header kontratı ve legacy→successor tam eşlemesi — tek merkezde. Bilgiler versioning kayıtlarından canlı türetilir.
Legacy (versiyonsuz) endpoint'ler için sunset: Wed, 01 Jul 2026 00:00:00 GMT
Bu tarihe kadar legacy yollar Deprecation + Link: successor-versionheader'larıyla yanıt verir; sonrasında kaldırılır. Yeni entegrasyonlar doğrudan /api/v1/* successor'ı kullanmalı (42 v1 ucu).
| Header | Değer | Açıklama |
|---|---|---|
| Deprecation | Wed, 01 Jul 2026 00:00:00 GMT | RFC 9745 — endpoint'in kullanımdan kalkacağı tarih (sunset). |
| Link | </api/v1/<successor>>; rel="successor-version" | Successor endpoint'e makine-okunur bağlantı (rel=successor-version). |
| X-API-Version | 0 | Legacy (versiyonsuz) yüzeyi işaretler — v1 yanıtlarında bulunmaz. |
| Legacy (deprecated) | Successor (/api/v1) | |
|---|---|---|
| /api/hesap/avatar | /api/v1/profile/avatar | |
| /api/hesap/export | /api/v1/profile/export | |
| /api/hesap/bilgiler | /api/v1/profile | |
| /api/hesap/veri-disa-aktar | /api/v1/profile/data-export | |
| /api/hesap/sil | /api/v1/profile/deletion | |
| /api/hesap/iptal | /api/v1/profile/deletion/cancel | |
| /api/credits/history | /api/v1/credits/history | |
| /api/credits | /api/v1/credits | |
| /api/auth/session | /api/v1/auth/session | |
| /api/chat/history | /api/v1/chat/history | |
| /api/chat/quota | /api/v1/chat/quota | |
| /api/chat | /api/v1/chat | |
| /api/conversations/end | /api/v1/conversations/end | |
| /api/forum/threads | /api/v1/forum/threads | |
| /api/forum/thread | /api/v1/forum/thread | |
| /api/forum/replies | /api/v1/forum/replies | |
| /api/forum/votes | /api/v1/forum/votes | |
| /api/search/popular | /api/v1/search/popular | |
| /api/search | /api/v1/search | |
| /api/plans | /api/v1/plans | |
| /api/abonelik | /api/v1/abonelik | |
| /api/avukatlar/cities | /api/v1/avukatlar/cities | |
| /api/avukatlar | /api/v1/avukatlar | |
| /api/avukat/verify | /api/v1/avukatlar/verify | |
| /api/reference/bars | /api/v1/avukatlar/bars | |
| /api/content | /api/v1/content | |
| /api/forum/categories | /api/v1/forum/categories | |
| /api/forum/leaderboard | /api/v1/forum/leaderboard | |
| /api/referral/dashboard | /api/v1/referral/dashboard | |
| /api/search/mevzuat | /api/v1/search/mevzuat | |
| /api/search/yargi | /api/v1/search/yargi | |
| /api/reference/cities | /api/v1/reference/cities | |
| /api/forum/bookmarks | /api/v1/forum/bookmarks | |
| /api/forum/tags | /api/v1/forum/tags | |
| /api/hesap/gorunurluk | /api/v1/hesap/gorunurluk | |
| /api/hesap/hizmet-alanlari | /api/v1/hesap/hizmet-alanlari | |
| /api/hesap/mesleki-bilgiler | /api/v1/hesap/mesleki-bilgiler | |
| /api/hesap/sertifikalar | /api/v1/hesap/sertifikalar | |
| /api/referral/leaderboard | /api/v1/referral/leaderboard | |
| /api/admin/inngest/retry/[runId] | /api/v1/admin/inngest/retry/[runId] | |
| /api/admin/cost-metrics | /api/v1/admin/cost-metrics | |
| /api/admin/referrals/analytics | /api/v1/admin/referrals/analytics |
Prefix eşlemesi: legacy path'in alt-yolları successor'a aynen taşınır (örn. /api/hesap/bilgiler/x → /api/v1/profile/x).
API erişimi Pro ve Enterprise tier tenant'lar için mevcuttur. Kendi entegrasyonunuzu hemen başlatın.