API დღესასწაულების კალენდარი Online
ევროპის ქვეყნების ოფიციალური საზეიმო დღეები — თარიღები, ადგილობრივი სახელები და ტიპი, თითოეული ქვეყნის დღეების სრული სია ჩართულია. მხარდაჭერილი იმავე Nager.Date / OpenHolidaysAPI სერვისის მიერ (7 დღის cache, ლოკალურად გამოთვლილი კოსოვოს კალენდარი), რომელიც უძღვება 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 ქვეყნის კოდი ან მძიმეებით გამოყოფილი სია შედარებისთვის. გადართვის შედარების რეჟიმში: აბრუნებს, თუ რომელი დღესასწაულის თარიღები საერთოა ყველა არჩეული ქვეყნისთვის (იგივე) და რომელთა მხოლოდ ზოგიერთისთვის (განსხვავებული, თითოეული თარიღისთვის ცალკე სიებით 'within/outside'). პარამეტრები upcoming და days ამასთან ერთად მუშაობენ — ვიწროებს იგივეს/განსხვავებულს არჩეულ თარიღთა ფანჯარამდე მთელი წლის მაგივრად. |
year | YYYY (ნაგულისხმევი: მიმდინარე წელი) |
upcoming | 1 = ქვეყნების მიხედვით მომავალი დღესასწაულების ბრტყელი სია რამდენიმე დღის განმავლობაში (არასავალდებულო) |
days | დღეების ჰორიზონტი მომავალი რეჟიმისთვის, 1-180. გამოტოვება ან 0 ნიშნავს შეზღუდვის გარეშე — ყველაფერი, რაც ძირითადი სერვისი ხედავს, ამ წელს და შემდეგ წელს. |
lang | ველი(ებ)ის ლოკალიზებული სახელისთვის ენა(ები) (ნაგულისხმევია en), nakordoni.eu-ს დღესასწაულების კალენდრის გვერდის მსგავსად 24 ენით. არაკეშირებული მონაცემებისთვის გამოიყენება ადგილობრივი ან ინგლისური სახელი. გამოყოფილი მძიმით, 10 ენამდე, მაგ. lang=en,uk,pl — სახელი აიღება პირველი მოთხოვნილი ენიდან; თითოეული დღესასწაული ასევე შეიცავს names ობიექტს ენის კოდებით, რომელიც შეიცავს ყველა თარგმანს. |
პასუხის ველები — პასუხის კონვერტის 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"