Skip to content

REST API Referansı

This content is not available in your language yet.

Bulgaristan Vatandaşlık Sorgulama API’si, Bulgaristan Adalet Bakanlığı (publicbg.mjs.bg) dosya takip sistemine doğrudan bağlıdır.


GET /api/status
Host: bgsorgulama.bulgaristanvatandas.com
Content-Type: application/json
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

Dosya numarası ve PIN kodu resmi sistemde bulunduğunda döndürülür:

{
"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"
}

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 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)”

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"
}

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"
}

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, OPTIONS
Access-Control-Allow-Headers: Content-Type, Authorization
Content-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 Content ve Access-Control-Max-Age: 86400 ile ö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.

API’mizin tam makine tarafından okunabilir OpenAPI 3.1 spesifikasyonuna aşağıdaki bağlantıdan erişebilirsiniz: