API пунктів обміну валют Online
Довідник пунктів обміну валют (канторів) у Польщі: назва, адреса, координати, години роботи, телефон, вебсайт і чи має пункт також оптові курси. Фільтр за містом, за валютою, яку котирує пункт, або лише ті, що відкриті зараз (за польським місцевим часом).
GET https://nakordoni.eu/api/v2/data/exchange-offices
— клас квоти: cheap
| Параметр | Опис |
|---|---|
city | Id міста з exchange-cities, напр. warszawa (необов'язково; без нього — усі міста) |
currency | Лише пункти, що котирують цю валюту, код ISO 4217, напр. EUR (необов'язково) |
open_now | 1 = лише пункти, відкриті зараз за опублікованими годинами, польський місцевий час (необов'язково) |
limit | Максимум пунктів у відповіді, 1-300 (за замовчуванням 100) |
lang | Мова назв міст і посилань на сторінки (за замовчуванням en) |
Поля відповіді — усередині об’єкта data у конверті відповіді. [] позначає список, тож data.items[].name — це поле name кожного елемента. Поле буває null, відсутнє або порожній список, коли значення в нас немає, — заглушок ми не підставляємо.
| Поле | Опис |
|---|---|
data.offices[].id | Id пункту — значення, яке приймають exchange-office та exchange-history. |
data.offices[].name | Назва пункту, разом з address, postal_code, city і city_name. |
data.offices[].lat | Координати (lat, lon); null, якщо невідомі. |
data.offices[].hours[] | Години роботи, по рядку на кожен проміжок: day (mo..su), open, close (HH:MM, польський місцевий час). День без рядка — вихідний. |
data.offices[].open_now | Чи відкритий пункт зараз за опублікованими годинами; null, якщо години невідомі. |
data.offices[].phones[] | Номери телефонів, як опубліковано, разом з website. |
data.offices[].has_wholesale | true = пункт також котирує оптові курси, що діють від мінімальної суми (див. exchange-office). |
data.offices[].has_current_rates | true = принаймні один курс оновлено за останні 72 години. |
data.offices[].currencies[] | Валюти, які пункт котирує в роздріб. |
data.offices[].url | Сторінка пункту на nakordoni.eu — ставте на неї посилання там, де показуєте дані. |
data.count | Кількість повернутих пунктів; total — кількість, що відповідає фільтрам, truncated = true, якщо limit обрізав список. |
Звідки беруться дані
Перелік пунктів обміну та їхні курси Nakordoni збирає з публічної інформації, яку публікують самі пункти обміну, перевіряє на помилки та показує поруч з офіційним довідковим курсом Національного банку Польщі (NBP). Кожен курс має час, коли він був чинним; курс, старший за 72 години, позначено is_current: false, і він ніколи не потрапляє в рейтинг.
Пункти обміну можуть будь-коли побачити, що збирає наш бот, зупинити його, виправити або видалити свій запис. Записи, які власник попросив видалити, зникають і з цих продуктів. NakordoniBot для пунктів обміну — інформація та відмова
Кожен рядок пункту містить url — його сторінку на nakordoni.eu. Ставте на неї посилання там, де показуєте дані.
curl "https://nakordoni.eu/api/v2/data/exchange-offices?city=krakow¤cy=EUR&open_now=1" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Оновлено