API kantorów Online
Katalog kantorów wymiany walut w Polsce: nazwa, adres, współrzędne, godziny otwarcia, telefon, strona internetowa i informacja, czy kantor podaje też kursy hurtowe. Filtr według miasta, waluty notowanej przez kantor lub tylko kantorów otwartych teraz (czas lokalny w Polsce).
GET https://nakordoni.eu/api/v2/data/exchange-offices
— klasa limitu: cheap
| Parametr | Opis |
|---|---|
city | Id miasta z exchange-cities, np. warszawa (opcjonalnie; pomiń, aby dostać wszystkie miasta) |
currency | Tylko kantory notujące tę walutę, kod ISO 4217, np. EUR (opcjonalnie) |
open_now | 1 = tylko kantory otwarte teraz według opublikowanych godzin, czas lokalny w Polsce (opcjonalnie) |
limit | Maksymalna liczba kantorów w odpowiedzi, 1-300 (domyślnie 100) |
lang | Język nazw miast i linków do stron (domyślnie en) |
Pola odpowiedzi — wewnątrz obiektu data w kopercie odpowiedzi. [] oznacza listę, więc data.items[].name to pole name każdego elementu. Pole bywa null, nieobecne lub jest pustą listą, gdy nie mamy wartości — nigdy nie wstawiamy atrapy.
| Pole | Opis |
|---|---|
data.offices[].id | Id kantoru — wartość, którą przyjmują exchange-office i exchange-history. |
data.offices[].name | Nazwa kantoru, wraz z address, postal_code, city i city_name. |
data.offices[].lat | Współrzędne (lat, lon); null, gdy nieznane. |
data.offices[].hours[] | Godziny otwarcia, jeden wiersz na każdy przedział: day (mo..su), open, close (HH:MM, czas lokalny w Polsce). Dzień bez wiersza jest zamknięty. |
data.offices[].open_now | Czy kantor jest teraz otwarty według opublikowanych godzin; null, gdy godziny są nieznane. |
data.offices[].phones[] | Numery telefonów w opublikowanej postaci, wraz z website. |
data.offices[].has_wholesale | true = kantor podaje też kursy hurtowe, obowiązujące od minimalnej kwoty (zob. exchange-office). |
data.offices[].has_current_rates | true = co najmniej jeden kurs zaktualizowano w ciągu ostatnich 72 godzin. |
data.offices[].currencies[] | Waluty, które kantor notuje detalicznie. |
data.offices[].url | Strona kantoru na nakordoni.eu — linkuj do niej tam, gdzie pokazujesz dane. |
data.count | Liczba zwróconych kantorów; total to liczba pasujących do filtrów, a truncated = true, gdy limit obciął listę. |
Skąd pochodzą dane
Listę kantorów i ich kursy Nakordoni zbiera z publicznych informacji, które publikują same kantory, sprawdza pod kątem błędów i pokazuje obok oficjalnego kursu referencyjnego Narodowego Banku Polskiego (NBP). Każdy kurs ma czas, w którym obowiązywał; kurs starszy niż 72 godziny jest oznaczony is_current: false i nigdy nie trafia do rankingu.
Kantory mogą w każdej chwili zobaczyć, co zbiera nasz bot, zatrzymać go, poprawić lub usunąć swój wpis. Wpisy, których usunięcia zażądał właściciel, znikają także z tych produktów. NakordoniBot dla kantorów — informacje i rezygnacja
Każdy wiersz kantoru zawiera url — jego stronę na nakordoni.eu. Linkuj do niej tam, gdzie pokazujesz dane.
curl "https://nakordoni.eu/api/v2/data/exchange-offices?city=krakow¤cy=EUR&open_now=1" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Zaktualizowano