Мереке күнтізбесі — Мерекелер 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 | Идентификатор бойынша бір мереке (басқа сүзгілер еленбейді) |
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 | Pro және одан жоғары жоспарларда include=impact кезінде: 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"
Жаңартылды