Общ Преглед

Публично достъпно API за изчисляване на ресто в евро при плащания с BGN и/или EUR.

Base URL: https://psdox.com/bgn2eur

Достъп

• Напълно безплатно
• Без API Key
• CORS enabled - може да се използва от всяка уеб страница
• Без rate limiting

Endpoints

1. JSON API

URL Pattern: GET /bgn2eur/json_api/{bill_amount}/{paid_bgn}/{paid_eur}

Пример: https://psdox.com/bgn2eur/json_api/12.34/30/0

Response:

{
  "success": true,
  "bill_amount": "12.34",
  "paid_eur": "0.00",
  "paid_bgn": "30.00",
  "paid_bgn_in_eur": "15.34",
  "total_paid_eur": "15.34",
  "change_eur": "3.00",
  "insufficient": false,
  "rate": 1.95583}
                

2. XML API

URL Pattern: GET /bgn2eur/xml_api/{bill_amount}/{paid_bgn}/{paid_eur}

Пример: https://psdox.com/bgn2eur/xml_api/12.34/30/0

Response:

<response>
  <success>true</success>
  <bill_amount>12.34</bill_amount>
  <paid_eur>0.00</paid_eur>
  <paid_bgn>30.00</paid_bgn>
  <paid_bgn_in_eur>15.34</paid_bgn_in_eur>
  <total_paid_eur>15.34</total_paid_eur>
  <change_eur>3.00</change_eur>
  <insufficient>false</insufficient>
  <rate>1.95583</rate>
</response>
    
                

Параметри

Параметър	Тип	Описание	Примери
bill_amount	float	Сума на сметката в EUR	12.34
paid_bgn	float	Платена сума в BGN	30.00
paid_eur	float	Платена сума в EUR	10.00

Забележки:

• Всички параметри са задължителни
• Ако не плащате с определена валута, използвайте: 0
• Десетичен разделител е точка (.)

Response Fields

Поле	Тип	Описание
success	boolean	Успешно ли е изчислението
bill_amount	string	Сума на сметката (EUR)
paid_eur	string	Платено в EUR
paid_bgn	string	Платено в BGN
paid_bgn_in_eur	string	BGN конвертирано в EUR
total_paid_eur	string	Общо платено в EUR
change_eur	string	Ресто в EUR
insufficient	boolean	Недостатъчна ли е сумата
rate	float	Официален използван курс BGN/EUR

Error Handling

JSON Response:

{
  "success": false,
  "error": "Invalid input: all values must be non-negative",
  "insufficient": true
}
                

XML Response:

<response>
  <success>false</success>
  <error>Invalid input: all values must be non-negative</error>
  <insufficient>true</insufficient>
</response>