API Տոնացույց Online
Եվրոպական երկրերի պաշտոնական հանրային տոները — ամսաթվեր, տեղական անվանումներ և դասակարգում, ներառված յուրաքանչյուր երկրի ամբողջական տոերի ցանկ: Աջակցվում է Nager.Date / OpenHolidaysAPI ծառայությամբ (7 օրվա քեշ, Կոսովոյի տեղայնորեն հաշվարկված օրացույց), որը հիմք կազմում է nakordoni.eu կայքի տոերի օրացույցին և կանխատեսման համակարգի ժամանակացանցային գործակիցներին: Մեկ երկրի համար վերադարձնում է հարթ օբյեկտ, մի քանիսի համար՝ նույն կառուցվածքը ցանկի մեջ: upcoming=1 պարամետրը անցկացնում է հարթ, ամսաթվով տեսակավորված միջերկրային հոսքի; compare_to պարամետրը ցուցադրում է համեմատություն երկրների միջև, որն օգտակար է ստուգելու համար, թե արդյոք ամսաթիվը տոն է սահմանային անցման երկու կողմերում, թե միայն մեկում:
GET https://nakordoni.eu/api/v1/data/holiday-calendar
— քվոտայի դաս: cheap
| Պարամետր | Նկարագրություն |
|---|---|
country | ISO-2 երկրի կոդ, կամ մինչև 15 կոդ պարունակող ստորակետով բաժանված ցուցակ, օրինակ՝ PL կամ PL,DE,UA: Թողնել ըստ умолчания (UA,PL,SK,HU,RO,MD,DE,CZ,BG,AT)։ Մի կոդը վերադարձնում է հարթ օբյեկտ, մի քանի կոդերը՝ ցուցակ։ |
compare_to | ISO-2 երկրի կոդ կամ ստորակետերով բաժանված ցանկ՝ համեմատության համար։ Միացնում է համեմատության ռեժիմը՝ վերադարձնում է, թե որ տոների ամսաթվերն են ընդհանուր բոլոր ընտրված երկրների համար (նույնը) և որերը միայն որոշների համար (տարբեր, յուրաքանչյուր ամսաթվի համար առանձին ներս/դուրս ցուցակներով)։ upcoming և days պարամետրերը աշխատում են դրա հետ միասին՝ նեղացնում են նույն/տարբերները ամբողջ տարվա փոխարեն ընտրված ամսաթվերի պատուհանին։ |
year | YYYY (նախադրված. ընթացիկ տարի) |
upcoming | 1 = երկրներով մի քանի օրից գալիք տոների հարթ ցուցակ (ընտրովի) |
days | Օրերի հորիզոնն ապագա ռեժիմի համար, 1-180: բաց թողնված կամ 0-ը նշանակում է սահմանափակման բացակայություն՝ այն ամենը, ինչ տեսնում է հիմնական ծառայությունը, այս տարին և հաջորդը: |
lang | Լեզուն(եր) տեղայնացված անվանում դաշտի համար (սկզբնապես en), ինչպես nakordoni.eu տոնացույցի էջում 24 լեզուներով։ Չկեշավորված տվյալների համար օգտագործվում է տեղական կամ անգլերեն անվանումը։ separated by commas, up to 10 languages, e.g. lang=en,uk,pl — name is taken from the first requested language; each holiday also has a names object keyed by language codes containing all translations. |
Պատասխանի դաշտերը — պատասխանի ծրարի data օբյեկտի ներսում։ []-ը ցույց է տալիս ցուցակ, ուստի data.items[].name-ը յուրաքանչյուր տարրի name դաշտն է։ Դաշտը լինում է null, բացակայում է կամ դատարկ ցուցակ է, երբ արժեք չունենք․ լցոնող արժեք երբեք չենք դնում։
| Դաշտ | Նկարագրություն |
|---|---|
data.countries | The countries compared — the one you asked about and compare_to. |
data.same[] | Days that are a public holiday in BOTH countries: date, weekday, names (one per country). |
data.different[] | Days that are a holiday in one country only: date, weekday, in (where it applies), not_in, names. These are the border-traffic days that catch drivers out. |
data.same_count | Size of same, with different_count for different. |
data.window | Period covered, inside data.year. |
data.mode | Single-country listing or two-country comparison. |
curl "https://nakordoni.eu/api/v1/data/holiday-calendar?country=PL&compare_to=UA&year=2026&lang=en" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"