İçeriğe geç

Hızlı Başlangıç

Bu içerik henüz dilinizde mevcut değil.

Bu rehber, herhangi bir kimlik doğrulama anahtarı beklemeden Bulgaristan Vatandaşlık Sorgulama API’sine nasıl istek atabileceğinizi ve gelen yanıtı uygulamanızda nasıl işleyebileceğinizi adım adım gösterir.


Sorgulama, tek bir HTTP GET isteği üzerinden gerçekleştirilir:

GET https://bgsorgulama.bulgaristanvatandas.com/api/status?reqNum={dosya_numarasi}&pin={pin_kodu}
Parametre Tip Örnek Açıklama
reqNum (veya caseNumber) string 14820/2023 Mülakat sonrası verilen dosya numarası (Yıl ile birlikte).
pin string 582910 Başvuru sahibine özel 6 haneli gizli PIN kodu.

Terminal veya konsoldan hızlı bir test gerçekleştirmek için:

Terminal window
curl -s "https://bgsorgulama.bulgaristanvatandas.com/api/status?reqNum=14820/2023&pin=582910"

Modern tarayıcılarda (React, Vue, Svelte) veya Node.js 18+ ortamında:

async function checkCitizenshipStatus(caseNumber, pin) {
const url = new URL("https://bgsorgulama.bulgaristanvatandas.com/api/status");
url.searchParams.set("reqNum", caseNumber);
url.searchParams.set("pin", pin);
try {
const res = await fetch(url.toString(), {
method: "GET",
headers: { "Accept": "application/json" }
});
const data = await res.json();
if (data.success) {
console.log(`Dosya: ${data.caseNumber}`);
console.log(`Türkçe Durum: ${data.statusTurkish}`);
console.log(`Bulgarca Orijinal: ${data.statusBulgarian}`);
if (data.isDecree) {
console.log(`🎉 TEBRİKLER! Ukaz çıktı: ${data.decreeNum}`);
}
return data;
} else {
console.warn(`Hata: ${data.message}`);
return null;
}
} catch (err) {
console.error("API bağlantı hatası:", err);
}
}
// Örnek çağrı:
checkCitizenshipStatus("14820/2023", "582910");

Python tabanlı backend sistemler veya otomasyon betikleri için:

import requests
def check_status(case_number: str, pin: str):
endpoint = "https://bgsorgulama.bulgaristanvatandas.com/api/status"
params = {
"reqNum": case_number,
"pin": pin
}
response = requests.get(endpoint, params=params, timeout=10)
data = response.json()
if response.status_code == 200 and data.get("success"):
print(f"Dosya: {data['caseNumber']}")
print(f"Aşama: {data['statusTurkish']}")
print(f"Telegram Takip Linki: {data['telegramBot']}")
return data
else:
print(f"Sorgu başarısız: {data.get('message', 'Bilinmeyen hata')}")
return None
# Test:
check_status("14820/2023", "582910")

WordPress, Laravel veya özel PHP yazılımları için:

<?php
function getBulgarianCitizenshipStatus($reqNum, $pin) {
$url = "https://bgsorgulama.bulgaristanvatandas.com/api/status?" . http_build_query([
'reqNum' => $reqNum,
'pin' => $pin,
]);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Accept: application/json']);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode === 200) {
$result = json_decode($response, true);
return $result;
}
return null;
}
$status = getBulgarianCitizenshipStatus('14820/2023', '582910');
if ($status && $status['success']) {
echo "Durum: " . htmlspecialchars($status['statusTurkish']);
}

Kullanıcılarınızı API sorgusundan sonra @Bulgaristanbot’a yönlendirerek, durumları her gün otomatik takip etmelerini ve değişiklik olduğunda anında bildirim almalarını sağlayabilirsiniz.

https://t.me/Bulgaristanbot?start=req_{caseNumber}_{pin}

(Not: Dosya numarasındaki eğik çizgi / alt tire _ karakterine dönüştürülür).

<a
href="https://t.me/Bulgaristanbot?start=req_14820_2023_582910"
target="_blank"
class="telegram-btn"
>
📱 Telegram'da 7/24 Otomatik Bildirim Al
</a>

Kullanıcı butona bastığında Telegram uygulaması açılır, bot tek tuşla başlatılır ve dosya otomatik olarak kullanıcının takip listesine eklenir!