API שערי לשכת המרה Online
לשכת המרה אחת עם שערי הקנייה והמכירה הנוכחיים שלה מול PLN. שערים קמעונאיים וסיטונאיים מוחזרים בנפרד: הסיטונאי חל רק מ-min_amount_pln ואין להשוות אותו לקמעונאי. לכל שער יש זמן משלו, כך שציטוט ישן לעולם אינו מוצג כשל היום.
GET https://nakordoni.eu/api/v2/data/exchange-office
— מחלקת מכסה: cheap
| פרמטר | תיאור |
|---|---|
id | id של לשכה מתוך exchange-offices (חובה) |
lang | שפת שם העיר וקישור הדף (ברירת מחדל en) |
שדות התשובה — בתוך אובייקט data שבמעטפת התשובה. [] מסמן רשימה, ולכן data.items[].name הוא שדה name של כל פריט. שדה יהיה null, ייעדר או יחזור כרשימה ריקה כשאין לנו ערך עבורו — לעולם לא ערך ממלא מקום.
| שדה | תיאור |
|---|---|
data.office | כל השדות של שורת exchange-offices, ובנוסף rates. |
data.office.rates.retail[].currency | קוד ISO 4217; buy ו-sell הם PLN ל-1 יחידה (buy = מה שהלשכה משלמת לכם, sell = מה שאתם משלמים ללשכה). |
data.office.rates.retail[].rate_time | מתי השער היה בתוקף, ISO 8601 עם היסט ה-UTC הפולני (למשל 2026-10-14T15:47:00+02:00). |
data.office.rates.retail[].is_current | false = השער ישן מ-72 שעות; הציגו אותו רק יחד עם rate_time. |
data.office.rates.wholesale[].min_amount_pln | העסקה הקטנה ביותר (ב-PLN) שממנה חל השער הסיטונאי; null כשהלשכה אינה מציינת. שאר השדות כמו ב-retail. |
data.office.rates.quote_currency | המטבע שבו מצוטטים כל השערים (PLN). |
מאיפה מגיעים הנתונים
את רשימת לשכות ההמרה ואת השערים שלהן Nakordoni אוספת ממידע ציבורי שהלשכות עצמן מפרסמות, בודקת לאיתור שגיאות ומציגה לצד שער הייחוס הרשמי של הבנק הלאומי של פולין (NBP). לכל שער יש את הזמן שבו היה בתוקף; שער ישן מ-72 שעות מסומן is_current: false ולעולם אינו נכנס לדירוג.
לשכות ההמרה יכולות בכל עת לראות מה הבוט שלנו אוסף, לעצור אותו, או לבקש לתקן או להסיר את הרישום שלהן. רישומים שהבעלים ביקש להסיר נעלמים גם מהמוצרים האלה. NakordoniBot ללשכות המרה — מידע ויציאה
כל שורת לשכה כוללת url — הדף שלה ב-nakordoni.eu. קשרו אליו במקום שבו אתם מציגים את הנתונים.
דוגמת תשובה
{
"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"
עודכן