Валюта айырбастау пункттері API Online
Польшадағы валюта айырбастау пункттерінің (kantors) анықтамалығы: атауы, мекенжайы, координаттары, жұмыс уақыты, телефоны, веб-сайты және пункттің көтерме бағам да беретін-бермейтіні. Қала, пункт ұсынатын валюта бойынша немесе тек қазір ашық пункттер (Польшаның жергілікті уақыты) бойынша сүзгі.
GET https://nakordoni.eu/api/v2/data/exchange-offices
— квота класы: cheap
| Параметр | Сипаттама |
|---|---|
city | exchange-cities ішіндегі қала id-і, мысалы 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 — сүзгілерге сәйкес келетін сан, ал limit тізімді қысқартқанда truncated = true. |
Деректер қайдан алынады
Айырбастау пункттерінің тізімі мен олардың бағамдарын 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"
Жаңартылды