API des bureaux de change Online
Annuaire des bureaux de change (kantors) en Pologne : nom, adresse, coordonnées, horaires, téléphone, site web et si le bureau propose aussi des cours de gros. Filtre par ville, par devise cotée, ou uniquement les bureaux ouverts maintenant (heure locale polonaise).
GET https://nakordoni.eu/api/v2/data/exchange-offices
— classe de quota: cheap
| Paramètre | Description |
|---|---|
city | Id de ville issu de exchange-cities, p. ex. warszawa (facultatif ; omettre pour toutes les villes) |
currency | Uniquement les bureaux qui cotent cette devise, code ISO 4217 comme EUR (facultatif) |
open_now | 1 = uniquement les bureaux ouverts maintenant selon leurs horaires publiés, heure locale polonaise (facultatif) |
limit | Nombre maximal de bureaux renvoyés, 1-300 (par défaut 100) |
lang | Langue des noms de villes et des liens de page (par défaut en) |
Champs de la réponse — à l’intérieur de l’objet data de l’enveloppe. [] indique une liste : data.items[].name est donc le champ name de chaque élément. Un champ vaut null, est absent ou est une liste vide quand nous n’avons pas de valeur — jamais un espace réservé.
| Champ | Description |
|---|---|
data.offices[].id | Id du bureau — la valeur attendue par exchange-office et exchange-history. |
data.offices[].name | Nom du bureau, avec address, postal_code, city et city_name. |
data.offices[].lat | Coordonnées (lat, lon) ; null si inconnues. |
data.offices[].hours[] | Horaires, une ligne par plage d'ouverture : day (mo..su), open, close (HH:MM, heure locale polonaise). Un jour sans ligne est fermé. |
data.offices[].open_now | Si le bureau est ouvert maintenant selon ses horaires publiés ; null si aucun horaire n'est connu. |
data.offices[].phones[] | Numéros de téléphone tels que publiés, avec website. |
data.offices[].has_wholesale | true = le bureau cote aussi des cours de gros, valables à partir d'un montant minimum (voir exchange-office). |
data.offices[].has_current_rates | true = au moins un cours a été mis à jour au cours des 72 dernières heures. |
data.offices[].currencies[] | Devises que le bureau cote au détail. |
data.offices[].url | La page du bureau sur nakordoni.eu — mettez-y un lien là où vous affichez les données. |
data.count | Bureaux renvoyés ; total est le nombre correspondant aux filtres et truncated vaut true quand limit a coupé la liste. |
D'où viennent les données
La liste des bureaux de change et leurs cours sont collectés par Nakordoni à partir d'informations publiques que les bureaux de change publient eux-mêmes, vérifiés contre les erreurs et affichés à côté du cours de référence officiel de la Banque nationale de Pologne (NBP). Chaque cours porte l'heure à laquelle il était valable ; un cours de plus de 72 heures est marqué is_current: false et n'entre jamais dans le classement.
Les bureaux de change peuvent à tout moment voir ce que collecte notre robot, l'arrêter, ou faire corriger ou retirer leur fiche. Les fiches dont le propriétaire a demandé le retrait disparaissent aussi de ces produits. NakordoniBot pour les bureaux de change — informations et retrait
Chaque ligne de bureau contient url — sa page sur nakordoni.eu. Mettez-y un lien là où vous affichez les données.
curl "https://nakordoni.eu/api/v2/data/exchange-offices?city=krakow¤cy=EUR&open_now=1" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Mis à jour