API курсове на обменно бюро Online
Едно обменно бюро с текущите му курсове купува и продава спрямо PLN. Курсовете на дребно и на едро се връщат отделно: на едро важи само от min_amount_pln и не бива да се сравнява с курса на дребно. Всеки курс носи собствено време, така че стара котировка никога не се представя като днешна.
GET https://nakordoni.eu/api/v2/data/exchange-office
— клас квота: cheap
| Параметър | Описание |
|---|---|
id | Id на бюро от exchange-offices (задължително) |
lang | Език на името на града и връзката към страницата (по подразбиране en) |
Полета на отговора — вътре в обекта data в плика на отговора. [] означава списък, така че data.items[].name е полето name на всеки елемент. Поле може да е null, да липсва или да е празен списък, когато нямаме стойност — никога не подставяме заместител.
| Поле | Описание |
|---|---|
data.office | Всички полета на ред от exchange-offices, плюс rates. |
data.office.rates.retail[].currency | Код ISO 4217; buy и sell са PLN за 1 единица (buy = колко бюрото плаща на вас, sell = колко вие плащате на бюрото). |
data.office.rates.retail[].rate_time | Кога е бил валиден този курс, ISO 8601 с полското UTC отместване (напр. 2026-10-14T15:47:00+02:00). |
data.office.rates.retail[].is_current | false = курсът е по-стар от 72 часа; показвайте го само заедно с rate_time. |
data.office.rates.wholesale[].min_amount_pln | Най-малката сделка (в PLN), от която важи курсът на едро; null, когато бюрото не я посочва. Другите полета както при retail. |
data.office.rates.quote_currency | Валутата, в която се котират всички курсове (PLN). |
Откъде идват данните
Списъкът с обменни бюра и техните курсове се събира от Nakordoni от публична информация, която публикуват самите обменни бюра, проверява се за грешки и се показва до официалния референтен курс на Националната банка на Полша (NBP). Всеки курс носи времето, в което е бил валиден; курс, по-стар от 72 часа, е отбелязан is_current: false и никога не влиза в класацията.
Обменните бюра могат по всяко време да видят какво събира нашият бот, да го спрат или да коригират или премахнат записа си. Записите, чието премахване собственикът е поискал, изчезват и от тези продукти. NakordoniBot за обменни бюра — информация и отказ
Всеки ред на бюро съдържа url — неговата страница в nakordoni.eu. Поставете връзка към нея там, където показвате данните.
Примерен отговор
{
"ok": true,
"product": "exchange-office",
"data": {
"office": {
"id": 3, "name": "Kantor …", "city": "przemysl", "address": "…, 37-700 Przemyśl",
"lat": 49.78449, "lon": 22.776614, "open_now": false, "has_wholesale": true,
"hours": [ { "day": "mo", "open": "08:00", "close": "17:00" } ],
"rates": {
"quote_currency": "PLN",
"retail": [ { "currency": "EUR", "buy": 4.33, "sell": 4.41,
"rate_time": "2026-10-14T15:47:00+02:00", "is_current": true } ],
"wholesale": [ { "currency": "EUR", "buy": 4.36, "sell": 4.385, "min_amount_pln": 4000,
"rate_time": "2026-10-14T15:47:00+02:00", "is_current": true } ]
}
}
}
}
curl "https://nakordoni.eu/api/v2/data/exchange-office?id=3" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Обновено