API Генериране на ЕГН

Endpoint

Parameters

Регион на раждане

Authorization

Не е необходима регистрация или токен.

Лимит: до 60 заявки на час от един IP адрес.

Изпратената информация не се записва никъде.

Request

POST /api/egn/generate HTTP/1.1
Host: egn.bg
Accept: application/json
Content-Type: application/x-www-form-urlencoded
        
day=12&month=5&year=1980&sex=1®ion=555&quantity=5

Response

Генерирани ЕГН и адрес за проверка:

{
  "valid": true,
  "result": [
    {
      "egn": 5406254557,
      "url": "https://egn.bg/egn/validirane/5406254557"
    },
    {
      "egn": 5003028823,
      "url": "https://egn.bg/egn/validirane/5003028823"
    },
    {
      "egn": 4503186091,
      "url": "https://egn.bg/egn/validirane/4503186091"
    },
    {
      "egn": "0208279460",
      "url": "https://egn.bg/egn/validirane/0208279460"
    },
    {
      "egn": 9612085810,
      "url": "https://egn.bg/egn/validirane/9612085810"
    }
  ]
}

Грешен формат :

{
  "valid": false,
  "errors": {
    "egn": [
      "ЕГН трябва да съдържа точно 10 цифри."
    ]
  }
}

Примери

cURL

curl -X POST https://egn.bg/api/egn/generate \
  -H "Accept: application/json" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "day=12&month=5&year=1980&sex=1&region=22&quantity=5"

Python (requests)

import requests

response = requests.post(
    "https://egn.bg/api/egn/generate",
    headers={"Accept": "application/json"},
    data={
        "day": 12,
        "month": 5,
        "year": 1980,
        "sex": 1,
        "region": 22,
        "quantity": 5
    }
)

print(response.json())

JavaScript (fetch)

fetch("https://egn.bg/api/egn/generate", {
  method: "POST",
  headers: {
    "Accept": "application/json",
    "Content-Type": "application/x-www-form-urlencoded"
  },
  body: new URLSearchParams({
    day: 12,
    month: 5,
    year: 1980,
    sex: 1,
    region: 22,
    quantity: 5
  })
})
.then(res => res.json())
.then(data => console.log(data));

Vue.js

this.$http.post(
  'https://egn.bg/api/egn/generate',
  new URLSearchParams({
    day: 12,
    month: 5,
    year: 1980,
    sex: 1,
    region: 22,
    quantity: 5
  }),
  {
    headers: { Accept: 'application/json' }
  }
).then(res => {
  console.log(res.data);
});

PHP (cURL)

<?php
$ch = curl_init("https://egn.bg/api/egn/generate");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => http_build_query([
        'day' => 12,
        'month' => 5,
        'year' => 1980,
        'sex' => 1,
        'region' => 22,
        'quantity' => 5
    ]),
    CURLOPT_HTTPHEADER => ["Accept: application/json"]
]);
$response = curl_exec($ch);
echo $response;
?>