REST API Referansı
Bu içerik henüz dilinizde mevcut değil.
Bulgaristan Vatandaşlık Sorgulama API’si, Bulgaristan Adalet Bakanlığı (publicbg.mjs.bg) dosya takip sistemine doğrudan bağlıdır.
📡 Endpoint Bilgisi
Section titled “📡 Endpoint Bilgisi”GET /api/statusHost: bgsorgulama.bulgaristanvatandas.comContent-Type: application/jsonİstek Parametreleri (Query String)
Section titled “İstek Parametreleri (Query String)”| Parametre | Tip | Zorunlu | Açıklama | Örnek |
|---|---|---|---|---|
reqNum |
string |
Evet | Dosya / Başvuru numarası (yıl formatıyla). Alternatif olarak caseNumber kullanılabilir. |
14820/2023 |
pin |
string |
Evet | Mülakat sonrası verilen 6 haneli gizli PIN kodu. | 582910 |
🟢 200 OK — Başarılı Sorgu
Section titled “🟢 200 OK — Başarılı Sorgu”Dosya numarası ve PIN kodu resmi sistemde bulunduğunda döndürülür:
Yanıt Modeli (JSON)
Section titled “Yanıt Modeli (JSON)”{ "success": true, "caseNumber": "14820/2023", "pinProvided": true, "statusBulgarian": "Преписката се намира в процедура по задължително съгласуване.", "statusTurkish": "Dosyanız ilgili güvenlik kurumlarının (İçişleri Bakanlığı MVR ve DANS) zorunlu koordinasyon ve tahkikat sürecindedir.", "isDecree": false, "decreeNum": null, "officialSource": "https://publicbg.mjs.bg/BgInfo/", "telegramBot": "https://t.me/Bulgaristanbot?start=req_14820_2023", "queriedAt": "2026-09-26T12:30:00.000Z"}Kararname (Ukaz) Onayı Örneği
Section titled “Kararname (Ukaz) Onayı Örneği”Başvuru Cumhurbaşkanı Yardımcılığı tarafından imzalanıp vatandaşlık onaylandığında:
{ "success": true, "caseNumber": "9812/2022", "pinProvided": true, "statusBulgarian": "Вашата преписка е включена в Указ 142 от 2024 г. Можете да резервирате час за получаване на удостоверението.", "statusTurkish": "Dosyanız 2024 yılı 142 sayılı Kararnameye (Ukaz) dahil edilmiştir. Vatandaşlığınız onaylanmıştır. Vatandaşlık belgenizi teslim almak üzere Sofya'dan randevu alabilirsiniz.", "isDecree": true, "decreeNum": "142/2024", "officialSource": "https://publicbg.mjs.bg/BgInfo/", "telegramBot": "https://t.me/Bulgaristanbot?start=req_9812_2022", "queriedAt": "2026-09-26T12:30:00.000Z"}Alan Açıklamaları
Section titled “Alan Açıklamaları”| Alan | Tip | Açıklama |
|---|---|---|
success |
boolean |
Sorgunun başarıyla tamamlanıp tamamlanmadığını belirtir (true). |
caseNumber |
string |
Sorgulanan dosya numarası. |
pinProvided |
boolean |
PIN kodunun sağlandığını teyit eder. |
statusBulgarian |
string |
Adalet Bakanlığı resmi sayfasındaki orijinal Bulgarca durum metni. |
statusTurkish |
string |
Doğal dil motoru tarafından üretilmiş resmi Türkçe çeviri ve hukuki açıklama. |
isDecree |
boolean |
Başvurunun Kararnameye (Ukaz) dahil edilip edilmediği (true ise vatandaşlık çıkmıştır). |
decreeNum |
string | null |
Varsa Ukaz numarası ve yılı (örn: 142/2024). |
officialSource |
string |
Doğrulama yapabileceğiniz resmi Adalet Bakanlığı portal linki. |
telegramBot |
string |
Kullanıcının Telegram üzerinden tek tıkla 7/24 otomatik takibe geçebileceği derin bağlantı. |
queriedAt |
string |
Sorgunun gerçekleştiği ISO 8601 zaman damgası. |
🔴 Hata Durum Kodları (Error Responses)
Section titled “🔴 Hata Durum Kodları (Error Responses)”400 Bad Request — Eksik Parametre
Section titled “400 Bad Request — Eksik Parametre”Dosya numarası veya PIN kodu belirtilmediğinde:
{ "error": "Missing parameters", "message": "Lütfen dosya numarası (reqNum, örn: 14820/2023) ve 6 haneli PIN kodunu (pin) belirtin.", "example": "/api/status?reqNum=14820/2023&pin=582910"}404 Not Found — Kayıt Bulunamadı
Section titled “404 Not Found — Kayıt Bulunamadı”Girilen dosya numarası veya PIN kodunun eşleşmemesi durumunda:
{ "success": false, "error": "Not Found", "message": "Belirtilen dosya numarası ve PIN ile eşleşen başvuru kaydı bulunamadı. Lütfen mülakat belgenizdeki bilgileri kontrol edin.", "raw": "Няма намерена преписка с тези данни.", "queriedAt": "2026-09-26T12:30:00.000Z"}503 Service Unavailable — Resmi Sunucu Koruması
Section titled “503 Service Unavailable — Resmi Sunucu Koruması”Bulgaristan Adalet Bakanlığı sunucusu bakımda olduğunda veya Cloudflare Turnstile koruması devreye girdiğinde:
{ "success": false, "status": "challenge_or_offline", "message": "Adalet Bakanlığı resmi sunucusu (publicbg.mjs.bg) şu anda yoğun güvenlik koruması veya bakım modundadır. Anlık otomatik kontrol için @Bulgaristanbot Telegram botunu kullanabilirsiniz.", "officialPortal": "https://publicbg.mjs.bg/BgInfo/", "telegramBot": "https://t.me/Bulgaristanbot?start=req_14820_2023", "queriedAt": "2026-09-26T12:30:00.000Z"}504 Gateway Timeout — Zaman Aşımı
Section titled “504 Gateway Timeout — Zaman Aşımı”Resmi sunucudan 6 saniye içerisinde yanıt alınamadığında:
{ "success": false, "error": "Gateway Timeout / Connection Error", "message": "The operation was aborted due to timeout", "queriedAt": "2026-09-26T12:30:00.000Z"}🛡️ HTTP Başlıkları (Headers) & Güvenlik Politikası
Section titled “🛡️ HTTP Başlıkları (Headers) & Güvenlik Politikası”API tüm yanıtlarda aşağıdaki standart başlıkları döndürür:
Access-Control-Allow-Origin: *Access-Control-Allow-Methods: GET, HEAD, OPTIONSAccess-Control-Allow-Headers: Content-Type, AuthorizationContent-Type: application/json; charset=utf-8- CORS Destekli: Herhangi bir alan adından (localhost dahil) doğrudan AJAX/Fetch çağrısı yapabilirsiniz.
- Preflight (OPTIONS): Preflight istekleri
204 No ContentveAccess-Control-Max-Age: 86400ile önbelleklenir. - Hız Kısıtlaması (Rate Limiting): Tek bir IP adresinden ardışık aşırı sorgular resmi portal korumasına takılabilir. İstekleriniz arasında en az 1-2 saniye bekleme süresi bırakmanız önerilir.
📄 OpenAPI Spesifikasyonu
Section titled “📄 OpenAPI Spesifikasyonu”API’mizin tam makine tarafından okunabilir OpenAPI 3.1 spesifikasyonuna aşağıdaki bağlantıdan erişebilirsiniz: