Hızlı Başlangıç
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.
⚡ 1. Temel Endpoint ve Parametreler
Section titled “⚡ 1. Temel Endpoint ve Parametreler”Sorgulama, tek bir HTTP GET isteği üzerinden gerçekleştirilir:
GET https://bgsorgulama.bulgaristanvatandas.com/api/status?reqNum={dosya_numarasi}&pin={pin_kodu}Gerekli Parametreler
Section titled “Gerekli Parametreler”| 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. |
💻 2. Kod Örnekleri
Section titled “💻 2. Kod Örnekleri”Terminal veya konsoldan hızlı bir test gerçekleştirmek için:
curl -s "https://bgsorgulama.bulgaristanvatandas.com/api/status?reqNum=14820/2023&pin=582910"JavaScript / TypeScript (Fetch API)
Section titled “JavaScript / TypeScript (Fetch API)”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 3 (Requests)
Section titled “Python 3 (Requests)”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")PHP (cURL)
Section titled “PHP (cURL)”WordPress, Laravel veya özel PHP yazılımları için:
<?phpfunction 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']);}🔗 3. Telegram Deep Link Entegrasyonu
Section titled “🔗 3. Telegram Deep Link Entegrasyonu”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.
Deep Link Formatı
Section titled “Deep Link Formatı”https://t.me/Bulgaristanbot?start=req_{caseNumber}_{pin}(Not: Dosya numarasındaki eğik çizgi / alt tire _ karakterine dönüştürülür).
Örnek Buton (HTML):
Section titled “Örnek Buton (HTML):”<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!
🎯 Sıradaki Adımlar
Section titled “🎯 Sıradaki Adımlar”- REST API Referansı sayfasından tüm HTTP durum kodlarını ve JSON şemasını inceleyin.
- Telegram Bot Entegrasyonu rehberinden gelişmiş bot özelliklerini keşfedin.
- Hukuk büronuz varsa, Toplu Dosya Takibi rehberi ile onlarca müvekkil dosyasını aynı anda nasıl izleyebileceğinizi öğrenin.