Տոնացույց — Holidays API Online
Պետական, բանկային, տարածաշրջանային, կրոնական և հիշատակի տոներ 51 երկրի (Եվրոպա + Ծոցի երկրներ) և դրանց տարածաշրջանների համար, 2020-2035, մեր սեփական տոների կանոնների շարժիչից։ Յուրաքանչյուր տոն նշում է՝ արդյոք այն հանգստյան օր է, բանկային տոն է կամ ընկնում է դպրոցական արձակուրդների մեջ, արդյոք հանգստյան օրվան ընկած տոնը տեղափոխվել է այլ օր, արդյոք դրա ամսաթիվը դեռ գնահատված է (իսլամական օրացույց), և արդյոք այդ օրը գործում է բեռնատարների երթևեկության արգելք և երբ։ Ընդգրկում է Ուկրաինայի ռազմական դրության կանոնը (տոները նշվում են, բայց հանգստյան օր չեն) և հրամանագրով օրերի տեղափոխումները (transfers[])։ Մինչև 10 երկիր մեկ հարցման համար՝ մեկ տարի կամ ցանկացած միջակայք մինչև 731 օր։
GET https://nakordoni.eu/api/v2/data/holiday-calendar/holidays
— քվոտայի դաս: cheap
| Պարամետր | Նկարագրություն |
|---|---|
country | ISO-2 երկրի կոդ կամ մինչև 10 կոդերի ստորակետով ցանկ (պարտադիր), օր.՝ DE կամ DE,PL,UA |
year | YYYY, 2020-2035 (լռելյայն՝ ընթացիկ տարին)։ Անտեսվում է, երբ ուղարկվում է from/to |
from | Միջակայքի սկիզբ YYYY-MM-DD (to-ի հետ. առավելագույնը 731 օր) |
to | Միջակայքի ավարտ YYYY-MM-DD |
region | ISO 3166-2 տարածաշրջան, օր.՝ DE-BY (կամ BY մեկ երկրի դեպքում). միայն ազգային տոներ + այդ տարածաշրջանի տոները։ Բաց թողեք բոլոր տարածաշրջանների համար |
type | Ստորակետով ֆիլտր՝ PUBLIC, BANK, REGIONAL, RELIGIOUS, OBSERVANCE, SCHOOL, OPTIONAL, HALF_DAY, BRIDGE կամ all։ Լռելյայն՝ ամեն ինչ, բացի BRIDGE-ից |
lang | Լեզվի կոդերի ստորակետով ցանկ name.translations-ի համար (լռելյայն՝ մեր ունեցած բոլոր լեզուները), օր.՝ en,uk,pl |
q | Որոնում տոների անուններում (ցանկացած լեզվով), օր.՝ christmas |
id | Մեկ տոն ըստ id-ի (մյուս ֆիլտրերն անտեսվում են) |
school | 1 = նաև ցուցադրել դպրոցական արձակուրդների ժամանակահատվածները (school_holidays[]) դրանք հրապարակող երկրների համար |
include | impact = ավելացնել business_intelligence յուրաքանչյուր տոնին (Pro և ավելի բարձր) |
min_impact | Միայն այն տոները, որոնց impact_score-ը առնվազն այսքան է (0-100). ենթադրում է include=impact |
Պատասխանի դաշտերը — պատասխանի ծրարի data օբյեկտի ներսում։ []-ը ցույց է տալիս ցուցակ, ուստի data.items[].name-ը յուրաքանչյուր տարրի name դաշտն է։ Դաշտը լինում է null, բացակայում է կամ դատարկ ցուցակ է, երբ արժեք չունենք․ լցոնող արժեք երբեք չենք դնում։
| Դաշտ | Նկարագրություն |
|---|---|
data.holidays[].id | Տոնի կայուն նույնացուցիչ, օր.՝ hol_de_christmas_day_2026 — ?id= պարամետրի ընդունած արժեքը։ Դիտարկվող (տեղափոխված) օրերը ավարտվում են _obs-ով։ |
data.holidays[].date | iso (YYYY-MM-DD), year, month, day, day_of_week (ISO 1=Երկուշաբթի..7=Կիրակի), day_name, is_weekend (երկրի հանգստյան օրեր)։ |
data.holidays[].name | en, local (local_lang լեզվով) և translations {lang: name}։ |
data.holidays[].location | country_code, scope NATIONAL կամ REGIONAL, regions_affected (ISO 3166-2 կոդեր)։ |
data.holidays[].classification | type, is_day_off, is_bank_holiday, is_school_holiday, is_bridge, estimated (հաշվարկված իսլամական օրացույցի ամսաթիվ), note (suspended_martial_law, transferred_by_decree կամ null)։ |
data.holidays[].floating_logic | is_floating, rule (ամսաթվի կանոնը պարզ լեզվով), shifted_from (սկզբնական ամսաթիվը, երբ հանգստյան օրվան ընկած տոնը տեղափոխվել է)։ |
data.holidays[].truck_ban | Տոնական բեռնատարների երթևեկության արգելք տվյալ երկրում՝ applies, time_from, time_until (տեղական ժամանակով), min_weight_tons, eve_rule {date,time_from,time_until} նախորդ օրվա արգելքի համար, scope_note։ |
data.holidays[].business_intelligence | include=impact պարամետրով Pro և ավելի բարձր պլաններում՝ նույն մոդելային գնահատված բլոկը, որը վերադարձնում է impact արտադրանքը։ |
data.transfers[] | Հրամանագրով օրերի տեղափոխումները պատուհանում՝ date, country_code, kind (day_off | working_day), region, note։ |
data.school_holidays[] | school=1-ի դեպքում՝ id, start_date, end_date, name, location։ |
data.count | Վերադարձված տոների քանակը. countries և window {from,to} կրկնում են հարցումը։ |
curl "https://nakordoni.eu/api/v2/data/holiday-calendar/holidays?country=DE&year=2026®ion=DE-BY&lang=en,de" \ -H "Authorization: Bearer NKD-DEV-XXXX-XXXX-XXXX"
Թարմացվել է