API לשכות המרת מטבע Online
מדריך לשכות המרת מטבע (kantors) בפולין: שם, כתובת, קואורדינטות, שעות פתיחה, טלפון, אתר, והאם הלשכה מצטטת גם שערים סיטונאיים. סינון לפי עיר, לפי מטבע שהלשכה מצטטת, או רק לשכות פתוחות עכשיו (שעון מקומי בפולין).
GET https://nakordoni.eu/api/v2/data/exchange-offices
— מחלקת מכסה: cheap
| פרמטר | תיאור |
|---|---|
city | id של עיר מתוך exchange-cities, למשל 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 הוא מספר התואמות למסננים, ו-truncated הוא true כאשר limit קיצץ את הרשימה. |
מאיפה מגיעים הנתונים
את רשימת לשכות ההמרה ואת השערים שלהן 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"
עודכן