Bulgaristanbot Geliştirici & API Dokümantasyonu
Bu içerik henüz dilinizde mevcut değil.
Bulgaristan Vatandaşlık Dosya Takip API’sine ve @Bulgaristanbot geliştirici platformuna hoş geldiniz.
Bu dokümantasyon; vatandaşlık danışmanları, hukuk büroları, bağımsız yazılım geliştiricileri ve yapay zeka ajanları için Bulgaristan Adalet Bakanlığı (MJS) dosya sorgulama ve otomatik bildirim altyapısının nasıl entegre edileceğini açıklar.
🚀 Temel Özellikler
Section titled “🚀 Temel Özellikler”- Resmi Veri Kaynağı: Doğrudan Bulgaristan Adalet Bakanlığı (
publicbg.mjs.bg) sistemiyle entegre. - RESTful JSON API: Basit HTTP GET istekleriyle anında Türkçe ve Bulgarca durum yanıtı.
- 7/24 Telegram Bildirim Sistemi: Tek tıkla derin bağlantı (Deep Link) üzerinden bot aboneliği oluşturma.
- AI & MCP Uyumluluğu: Claude Desktop, Cursor ve LLM ajanları için yerleşik Model Context Protocol (MCP) desteği.
- Yüksek Hız & Kesintisiz Erişim: Optimize edilmiş yüksek performanslı dağıtık API altyapısı.
🧭 Hızlı Gezinti
Section titled “🧭 Hızlı Gezinti”- Genel Bakış — API mimarisi ve sorgulama mekanizması.
- Hızlı Başlangıç — 5 dakikada ilk API çağrınızı yapın (cURL, Node.js, Python).
- En İyi Uygulamalar & Limitler — Önbellekleme, sorgu sıklığı ve veri güvenliği.
- API Referansı —
GET /api/statusparametreleri, şemalar ve yanıt kodları. - Telegram Bot Entegrasyonu — Deep link protokolü ve web sitesi butonları.
- Toplu Dosya Takibi — Danışmanlık ve hukuk büroları için CSV/Excel kurgusu.
- AI & MCP Sunucusu — Yapay zeka araçları için MCP Server kurulumu.
⚡ Canlı API Örneği
Section titled “⚡ Canlı API Örneği”curl -s "https://bgsorgulama.bulgaristanvatandas.com/api/status?reqNum=14820/2023&pin=582910"{ "success": true, "caseNumber": "14820/2023", "statusBulgarian": "Преписката се намира в процедура по задължително съгласуване.", "statusTurkish": "Dosyanız ilgili güvenlik birimlerinin (DANS, İçişleri Bakanlığı) incelemesindedir.", "isDecree": false, "decreeNum": null, "officialSource": "https://publicbg.mjs.bg/BgInfo/", "telegramBot": "https://t.me/Bulgaristanbot?start=req_14820_2023", "queriedAt": "2026-09-26T12:00:00.000Z"}