API e kurseve të një zyre këmbimi Online
Një zyrë këmbimi me kurset e saj aktuale të blerjes dhe shitjes kundrejt PLN. Kurset me pakicë dhe me shumicë kthehen veçmas: kursi me shumicë vlen vetëm nga min_amount_pln dhe nuk duhet krahasuar me atë me pakicë. Çdo kurs mban kohën e vet, kështu që një kuotim i vjetër nuk paraqitet kurrë si i sotëm.
GET https://nakordoni.eu/api/v2/data/exchange-office
— klasa e kuotës: cheap
| Parametri | Përshkrimi |
|---|---|
id | Id e zyrës nga exchange-offices (e detyrueshme) |
lang | Gjuha e emrit të qytetit dhe e lidhjes së faqes (parazgjedhje en) |
Fushat e përgjigjes — brenda objektit data të zarfit të përgjigjes. [] shënon një listë, pra data.items[].name është fusha name e çdo elementi. Një fushë është null, mungon ose është listë bosh kur nuk kemi vlerë — kurrë një vendmbajtëse.
| Fusha | Përshkrimi |
|---|---|
data.office | Të gjitha fushat e një rreshti exchange-offices, plus rates. |
data.office.rates.retail[].currency | Kod ISO 4217; buy dhe sell janë PLN për 1 njësi (buy = sa ju paguan zyra, sell = sa i paguani ju zyrës). |
data.office.rates.retail[].rate_time | Kur ishte i vlefshëm ky kurs, ISO 8601 me zhvendosjen UTC polake (p.sh. 2026-10-14T15:47:00+02:00). |
data.office.rates.retail[].is_current | false = kursi është më i vjetër se 72 orë; shfaqeni vetëm së bashku me rate_time. |
data.office.rates.wholesale[].min_amount_pln | Transaksioni më i vogël (në PLN) nga i cili vlen kursi me shumicë; null kur zyra nuk e jep. Fushat e tjera si te retail. |
data.office.rates.quote_currency | Monedha në të cilën kuotohen të gjitha kurset (PLN). |
Nga vijnë të dhënat
Listën e zyrave të këmbimit dhe kurset e tyre Nakordoni i mbledh nga informacioni publik që publikojnë vetë zyrat e këmbimit, i kontrollon për gabime dhe i shfaq pranë kursit zyrtar të referencës së Bankës Kombëtare të Polonisë (NBP). Çdo kurs mban kohën kur ishte i vlefshëm; një kurs më i vjetër se 72 orë shënohet is_current: false dhe nuk hyn kurrë në renditje.
Zyrat e këmbimit mund të shohin në çdo kohë çfarë mbledh boti ynë, ta ndalin ose të kërkojnë korrigjimin ose heqjen e regjistrimit të tyre. Regjistrimet që pronari ka kërkuar t'i hiqen zhduken edhe nga këto produkte. NakordoniBot për zyrat e këmbimit — informacion dhe tërheqje
Çdo rresht zyre përmban url — faqen e saj në nakordoni.eu. Vendosni një lidhje drejt saj aty ku shfaqni të dhënat.
Shembull përgjigjeje
{
"ok": true,
"product": "exchange-office",
"data": {
"office": {
"id": 3, "name": "Kantor …", "city": "przemysl", "address": "…, 37-700 Przemyśl",
"lat": 49.78449, "lon": 22.776614, "open_now": false, "has_wholesale": true,
"hours": [ { "day": "mo", "open": "08:00", "close": "17:00" } ],
"rates": {
"quote_currency": "PLN",
"retail": [ { "currency": "EUR", "buy": 4.33, "sell": 4.41,
"rate_time": "2026-10-14T15:47:00+02:00", "is_current": true } ],
"wholesale": [ { "currency": "EUR", "buy": 4.36, "sell": 4.385, "min_amount_pln": 4000,
"rate_time": "2026-10-14T15:47:00+02:00", "is_current": true } ]
}
}
}
}
curl "https://nakordoni.eu/api/v2/data/exchange-office?id=3" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Përditësuar