https://egn.bg/api/egn/validateegn — задължителен текстов низ с точно 10 цифри. Изпращайте го като текст, за да запазите водещите нули. Поддържат се JSON и form-urlencoded заявки.
Заявка
curl https://egn.bg/api/egn/validate \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{"egn":"8507247504"}'const response = await fetch(
'https://egn.bg/api/egn/validate', {
method: 'POST',
headers: {
'Accept': 'application/json',
'Content-Type': 'application/json'
},
body: JSON.stringify({ egn: '8507247504' })
}
);
const data = await response.json();<?php
$ch = curl_init('https://egn.bg/api/egn/validate');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Accept: application/json',
'Content-Type: application/json'
],
CURLOPT_POSTFIELDS => json_encode([
'egn' => '8507247504'
])
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);import requests
response = requests.post(
'https://egn.bg/api/egn/validate',
headers={'Accept': 'application/json'},
json={'egn': '8507247504'},
timeout=10
)
data = response.json()Примерът за Python използва requests.
Отговор 200 · съкратен пример
{
"valid": true,
"result": {
"data": {
"birthday_iso": "1985-07-24",
"sex_text": "мъж",
"region_num": "750",
"region_text": "София - окръг"
}
}
}valid: true потвърждава структурата и контролната цифра, а не че ЕГН е действително издаден.
Какви данни съдържа пълният отговор?
result.data — дата (year, month, day, birthday_text, birthday_iso), възраст (age), пол (sex, sex_text), регион (region_num, region_text), поредност (birthnumber), зодия (zodiac) и личности, родени на същата дата (famous).
result.compiled — готов HTML блок. result.narrative — текстово описание. famous е списък или null; възрастта се изчислява към момента на заявката.
Невалидни данни и ограничения
200 10 цифри, но невалидна дата или контролна цифра
{
"valid": false,
"message": "Въведенето ЕГН не е валидно!"
}422 Липсващо поле или грешен формат
{
"valid": false,
"errors": {
"egn": ["ЕГН трябва да съдържа точно 10 цифри."]
}
}429 Надвишен лимит на заявките
Изчакайте времето от HTTP заглавката Retry-After, преди да изпратите следваща заявка.