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"
Обновлено