EvrakAI
EvrakAI Developer Platform · v1

Türkiye'nin hukuk
altyapı API'si

20 milyon+ içtihat, AI belge üretimi, hukuki hesaplama ve AI sohbet — tek REST API. RESTful uçlar, öngörülebilir kredi modeli, dakikalar içinde entegrasyon.

API Anahtarı AlOpenAPI Şeması
API anahtarı auth Kendi altyapımız · SLA 4 servis, tek entegrasyon

Hızlı Başlangıç

API anahtarınızı aldıktan sonra tek bir istekle başlayın. Tüm uçlar https://evrakai.com/api/v1 altında, JSON gövde ile çalışır ve JSON döner.

curl -X POST https://evrakai.com/api/v1/case-law/search \
  -H "Authorization: Bearer evk_live_ANAHTARINIZ" \
  -H "Content-Type: application/json" \
  -d '{ "query": "kira sözleşmesi tahliye taahhüdü", "limit": 5 }'

Kimlik Doğrulama

Her istek bir API anahtarı gerektirir. Anahtarınızı Authorization başlığında Bearer token olarak gönderin. Alternatif olarak x-api-key başlığı da desteklenir.

Anahtarınızı gizli tutun. İstemci tarafı (tarayıcı) kodunda ifşa etmeyin — istekleri kendi sunucunuzdan yapın.

Krediler & Limitler

Her işlem, maliyetine göre planınızın aylık kredi kotasından düşer. Ucuz işlemler bol, AI işlemleri ağır sayılır.

İçtihat araması / detay1 kredi
Hukuki hesaplama1 kredi
AI hukuki sohbet5 kredi
AI belge üretimi20 kredi

Rate limit yanıt başlıklarında bildirilir: X-RateLimit-Limit, X-RateLimit-Remaining. Limit aşımında 429 ve Retry-After döner.

İçtihat API

scope: case-law

20 milyon+ Yargıtay, Danıştay ve emsal karar üzerinde semantik arama. Yalnızca kendi altyapımızdan servis edilir — hızlı, kesintisiz, SLA verilebilir.

POST
/api/v1/case-law/search

Semantik içtihat araması

1 kredicase-law
GET
/api/v1/case-law/{id}

Karar tam metni

1 kredicase-law

Örnek: arama + yanıt

curl -X POST https://evrakai.com/api/v1/case-law/search \
  -H "Authorization: Bearer evk_live_ANAHTARINIZ" \
  -d '{ "query": "haksız fesih kıdem tazminatı", "court": "yargitay", "limit": 10 }'

Hesaplama API

scope: calc

Tazminat, vergi, faiz, nafaka ve 20+ hukuki hesaplama aracı. Güncel oranlarla, dış bağımlılık olmadan.

POST
/api/v1/calculations

Bir hesaplama aracını çalıştır

1 kredicalc
GET
/api/v1/calculations

Kullanılabilir araçların listesi

0 kredicalc
curl -X POST https://evrakai.com/api/v1/calculations \
  -H "Authorization: Bearer evk_live_ANAHTARINIZ" \
  -d '{ "tool": "kidem-tazminati", "input": { "grossSalary": 50000, "startDate": "2020-01-01", "endDate": "2026-01-01" } }'

Belge Üretimi API

scope: documents

Dilekçe, sözleşme, ihtarname ve 120+ şablonla yapay zekâ destekli hukuki belge üretimi. AI token yaktığı için 20 kredi.

POST
/api/v1/documents/generate

AI ile belge üret

20 kredidocuments
GET
/api/v1/documents/templates

Şablon listesi (answerFields dahil)

0 kredidocuments
curl -X POST https://evrakai.com/api/v1/documents/generate \
  -H "Authorization: Bearer evk_live_ANAHTARINIZ" \
  -d '{ "template": "ihtarname", "answers": { /* şablon alanları */ } }'

AI Sohbet API

scope: chat

İçtihat referanslı yapay zekâ hukuki soru-cevap. Yanıtla birlikte dayanak kararlar döner.

POST
/api/v1/chat

AI hukuki sohbet (içtihat referanslı)

5 kredichat
curl -X POST https://evrakai.com/api/v1/chat \
  -H "Authorization: Bearer evk_live_ANAHTARINIZ" \
  -d '{ "message": "Kira artışında yıllık üst sınır nedir?" }'

Hata Kodları

Hatalar tutarlı JSON formatında döner: { "error": { "code", "message" } }

HTTPcodeAnlamı
400invalid_json / missing_toolGeçersiz istek gövdesi veya eksik alan
401missing_api_key / invalid_api_keyAnahtar yok veya geçersiz
403insufficient_scope / revoked_api_keyYetki yok veya anahtar iptal
404not_found / template_not_foundKaynak bulunamadı
429rate_limit_exceeded / quota_exceededHız limiti veya aylık kota aşımı
503feature_disabledİşlev geçici olarak devre dışı

OpenAPI Şeması

Makine-okunur OpenAPI 3.1 şeması. Postman, Insomnia veya kod üreteçlerine (openapi-generator) doğrudan aktarabilirsiniz.

openapi.json · OpenAPI 3.1
{
  "openapi": "3.1.0",
  "info": {
    "title": "EvrakAI API",
    "version": "1.0.0",
    "description": "İçtihat araması, hukuki hesaplama, AI belge üretimi ve AI hukuki sohbet API'si. Kimlik doğrulama: Authorization: Bearer <api_anahtarı>."
  },
  "servers": [
    {
      "url": "https://evrakai.com/api/v1"
    }
  ],
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "evk_live_ ile başlayan API anahtarı"
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              }
            }
          }
        }
      }
    }
  },
  "paths": {
    "/case-law/search": {
      "post": {
        "summary": "İçtihat araması (semantik, kendi veritabanımızdan)",
        "description": "Kredi maliyeti: 1. Scope: case-law.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "query"
                ],
                "properties": {
                  "query": {
                    "type": "string",
                    "description": "Arama sorgusu (min 2 karakter)"
                  },
                  "court": {
                    "type": "string",
                    "enum": [
                      "yargitay",
                      "danistay",
                      "emsal",
                      "anayasa"
                    ],
                    "description": "Mahkeme filtresi (opsiyonel)"
                  },
                  "limit": {
                    "type": "integer",
                    "default": 20,
                    "maximum": 50
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Arama sonuçları"
          },
          "401": {
            "description": "Geçersiz anahtar"
          },
          "429": {
            "description": "Limit/kota aşımı"
          }
        }
      }
    },
    "/case-law/{id}": {
      "get": {
        "summary": "Karar tam metni",
        "description": "Kredi maliyeti: 1. Scope: case-law. Karar veritabanımızda yoksa 404.",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "court",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Karar tam metni"
          },
          "404": {
            "description": "Bulunamadı"
          }
        }
      }
    },
    "/calculations": {
      "post": {
        "summary": "Hukuki hesaplama",
        "description": "Kredi maliyeti: 1. Scope: calc. Araç listesi için GET /calculations.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "tool",
                  "input"
                ],
                "properties": {
                  "tool": {
                    "type": "string",
                    "description": "Araç kimliği (ör: kidem-tazminati)"
                  },
                  "input": {
                    "type": "object",
                    "description": "Araca özel girdi alanları"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Hesaplama sonucu"
          },
          "404": {
            "description": "Bilinmeyen araç"
          }
        }
      },
      "get": {
        "summary": "Kullanılabilir hesaplama araçları listesi",
        "responses": {
          "200": {
            "description": "Araç kataloğu"
          }
        }
      }
    },
    "/documents/generate": {
      "post": {
        "summary": "AI ile hukuki belge üretimi",
        "description": "Kredi maliyeti: 20 (AI token yakar). Scope: documents. Şablon listesi için GET /documents/templates.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "template",
                  "answers"
                ],
                "properties": {
                  "template": {
                    "type": "string",
                    "description": "Şablon slug"
                  },
                  "answers": {
                    "type": "object",
                    "description": "Şablonun beklediği alanlar"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Üretilen belge metni"
          },
          "404": {
            "description": "Şablon bulunamadı"
          }
        }
      }
    },
    "/documents/templates": {
      "get": {
        "summary": "Belge şablonları listesi",
        "description": "Scope: documents.",
        "responses": {
          "200": {
            "description": "Şablon listesi (answerFields dahil)"
          }
        }
      }
    },
    "/chat": {
      "post": {
        "summary": "AI hukuki sohbet (içtihat referanslı)",
        "description": "Kredi maliyeti: 5 (AI token yakar). Scope: chat.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "message"
                ],
                "properties": {
                  "message": {
                    "type": "string",
                    "description": "Hukuki soru (min 2, max 4000 karakter)"
                  },
                  "history": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "role": {
                          "type": "string"
                        },
                        "content": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "specialization": {
                    "type": "string",
                    "description": "Uzmanlık alanı ipucu (opsiyonel)"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "AI yanıtı + içtihat referansları"
          }
        }
      }
    }
  }
}

Fiyatlandırma

Aylık abonelik + kredi. Krediler işlev maliyetine göre harcanır.

Ücretsiz

0₺
200 kredi/ay
5 istek/dk
Deneme ve entegrasyon testi

Başlangıç

1.500₺/ay
3.000 kredi/ay
30 istek/dk
Solo avukat, küçük büro
Popüler

Pro

6.000₺/ay
15.000 kredi/ay
120 istek/dk
Orta ölçek, legal-tech

Business

18.000₺/ay
60.000 kredi/ay
300 istek/dk
Kurumsal, yeniden satıcı

Kurumsal

Teklif
Özel kredi/ay
Özel istek/dk
Banka, sigorta, kamu + SLA

Fiyatlar KDV hariçtir. Kurumsal ihtiyaçlar için özel planlar ve SLA sunulur.

Entegrasyona başlayalım

İhtiyacınızı iletin, size uygun planı ve API anahtarınızı hazırlayalım.

API Anahtarı Al