Hızlı Başlangıç
This content is not available in your language yet.
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.