Bağlantılar ve geliştirici erişimi
Canlı uç noktalar
- Genel API (HTTPS)
https://ragsource.turuncupro.com- MCP-RAG
https://ragsource.turuncupro.com/mcp/rag- REST arama
https://ragsource.turuncupro.com/v1/search- Sağlık
https://ragsource.turuncupro.com/health·https://ragsource.turuncupro.com/readyready- Embedding / Reranker
- openai:text-embedding-3-small / disabled
Semantik arama OpenAI üzerinden (text-embedding-3-small).
Sunucu içi PM2: API 127.0.0.1:8010, UI 127.0.0.1:3010 (nginx üzerinden HTTPS ile yayınlanır).
https://ragsource.turuncupro.com/v1- Biçim
- JSON
- Kimlik doğrulama
- X-API-Key veya Bearer
- Kullanım
- Hukuk yazılımları, CRM, dava ve içtihat uygulamaları
https://ragsource.turuncupro.com/v1/changes.ndjson- Biçim
- NDJSON
- Kimlik doğrulama
- X-API-Key veya Bearer
- Kullanım
- Yerel veri aynalama, indeks ve önbellek güncelleme
https://ragsource.turuncupro.com/mcp/rag- Biçim
- JSON-RPC / MCP
- Kimlik doğrulama
- X-API-Key veya Bearer
- Kullanım
- AI hukuk asistanı: RAG (hibrit/semantik/leksikal) + resmi kaynak edinimi (ext_*)
https://ragsource.turuncupro.com/mcp/external- Biçim
- JSON-RPC / MCP
- Kimlik doğrulama
- X-API-Key veya Bearer
- Kullanım
- Kaynak edinme (aynı araçlar /mcp/rag üzerinde de mevcut)
https://ragsource.turuncupro.com/v1/openapi.json- Biçim
- OpenAPI JSON
- Kimlik doğrulama
- X-API-Key veya Bearer
- Kullanım
- SDK üretimi ve hızlı entegrasyon
AI Hukuk Asistanı — MCP + RAG
Tek MCP bağlantısı (https://ragsource.turuncupro.com/mcp/rag): RAG (corpus’tan passage) ve MCP edinimi (resmi kaynaklardan yeni karar/mevzuat çekme). Asistan rag_search ile soruyu gönderir.
Arama modu (RAG)
Connect AI assistant to /mcp/rag only — includes RAG search + ext_* acquisition tools. Mod seçimi mode parametresi ile yapılır.
Güncel içerik (varsayılan)
syncExternal: true — resmi kaynaklarda arama. awaitIngestion: true — yeni belgeler içe aktarılır, corpus yeniden sorgulanır.
Kaynak kapsamı
Ön tanımlı gruplar veya tek tek kaynak seçimi. Boş / Tümü = tüm etkin kaynaklar.
MCP — rag_search (birincil)
{
"method": "tools/call",
"params": {
"name": "rag_search",
"arguments": {
"question": "Alt kiracı olarak oturan müvekkilimizin, asıl kira sözleşmesi feshedildiğinde tahliye edilip edilemeyeceği",
"k": 8,
"mode": "hybrid",
"syncExternal": true,
"awaitIngestion": true
}
}
}MCP araçları (RAG + edinim)
| Araç | Tür | Ne zaman |
|---|---|---|
rag_search | RAG+MCP | Varsayılan — hibrit/semantik/leksikal + güncel kaynak |
rag_hybrid_search | RAG | Leksikal + semantik birleşik |
rag_semantic_search | RAG | Kavramsal / paraphrase sorular |
rag_lexical_search | RAG | Madde no, esas/karar no, tam terim |
rag_list_sources | Meta | Kaynak ve ön tanım listesi |
rag_get_document | RAG | Tam karar/mevzuat metni |
ext_search | MCP | Resmi kaynakta doğrudan metadata arama |
ext_fetch_document | MCP→RAG | Tek belge çek ve corpus’a ekle |
ext_search_and_ingest | MCP→RAG | Kaynakta ara + toplu içe aktar |
ext_job_status | MCP | İçe aktarma iş durumu |
REST — AI backend
curl -H "X-API-Key: ulaw_..." \ "https://ragsource.turuncupro.com/v1/search?q=Alt%20kirac%C4%B1%20olarak%20oturan%20m%C3%BCvekkilimizin%2C%20as%C4%B1l%20kira%20s%C3%B6zle%C5%9Fmesi%20feshedildi%C4%9Finde%20tahliye%20edilip%20edilemeyece%C4%9Fi&mode=hybrid"
REST — POST
curl -X POST -H "X-API-Key: ulaw_..." -H "Content-Type: application/json" \
"https://ragsource.turuncupro.com/v1/search" \
-d '{
"query": "Alt kiracı olarak oturan müvekkilimizin, asıl kira sözleşmesi feshedildiğinde tahliye edilip edilemeyeceği",
"question": "Alt kiracı olarak oturan müvekkilimizin, asıl kira sözleşmesi feshedildiğinde tahliye edilip edilemeyeceği",
"k": 8,
"mode": "hybrid",
"syncExternal": true,
"awaitIngestion": true
}'Yanıt yapısı
{
"mode": "hybrid",
"externalSync": true,
"freshness": { "officialSourcesChecked": true, "corpusRequeried": true },
"results": [{ "passage": "…", "reference": { "bibliographic": "…" } }],
"assistant": { "howToCite": "…", "suggestedFollowUp": "…" }
}Kaynak kataloğu
| Kaynak | ID | Katman |
|---|---|---|
| Anayasa Mahkemesi | anayasa | http-json |
| BDDK | bddk | http-json |
| Bedesten İçtihat | bedesten-ictihat | http-json |
| Bedesten Mevzuat | bedesten-mevzuat | http-json |
| Danıştay | danistay | http-session |
| Emsal | emsal | http-session |
| GİB Özelge | gib | http-json |
| KVKK | kvkk | scrape |
| Rekabet Kurulu | rekabet | scrape |
| Sigorta Tahkim | sigorta-tahkim | http-json |
| tavily | tavily | http-json |
| Uyuşmazlık Mahkemesi | uyusmazlik | webforms |
| Yargıtay | yargitay | http-session |
API istemcileri
Hızlı başlangıç
Bir API anahtarı oluşturun ve hukuk yazılımınızdan aşağıdaki biçimde bağlanın.
curl -H "X-API-Key: ulaw_..." \ "https://ragsource.turuncupro.com/v1/search?q=mülkiyet+hakkı&sourcePreset=ictihat&mode=lexical"
Kaynak listesi için /v1/sources veya /api/sources kullanın. Artımlı eşitleme için /v1/changes.ndjson?after=... çağrısını kullanın.
Kullanım ölçümleri
| client_name | protocol | operation | requests | avg_duration_ms | last_request_at |
|---|---|---|---|---|---|
| AI Assistant | rest | POST /v1/search | 62 | 12134 | 2026-06-15T08:02:32.855Z |
| test-client-2026 | mcp | POST /mcp/rag | 23 | 5814 | 2026-06-13T12:35:28.010Z |
| test-client-2026 | rest | GET /v1/sources | 1 | 2 | 2026-06-13T11:55:37.602Z |
| test-client-2026 | rest | GET /v1/search | 1 | 28888 | 2026-06-13T11:55:36.558Z |