कैलेंडर
Libre WebUI निजी कैलेंडर देता है। हर उपयोगकर्ता को एकबारगी और आवर्ती कार्यक्रमों के साथ माह/सप्ताह दृश्य मिलता है; निर्धारित ऑटोमेशन की आने वाली घटनाएँ और इतिहास उसी ग्रिड में दिखते हैं।
कार्यक्रम
कार्यक्रम में शीर्षक, वैकल्पिक नोट, प्रारंभ, वैकल्पिक अंत, पूरे दिन का फ़्लैग और पुनरावृत्ति नियम होता है। शीर्षक/नोट चैट और नोट्स की तरह एन्क्रिप्ट होते हैं।
| प्रकार | फ़ील्ड | अर्थ |
|---|---|---|
once | at | एक घटना |
hourly | minute, startHour?, endHour? | समय खिड़की में हर घंटा |
daily | hour, minute | हर दिन दीवार-घड़ी समय |
weekly | dayOfWeek, hour, minute | चुने दिन हर सप्ताह |
monthly | dayOfMonth, hour, minute | चुने दिन हर माह |
yearly | month, dayOfMonth, hour, minute | चुनी तारीख हर वर्ष |
आवर्ती कार्यक्रम एक बार सहेजा जाता है। रेंज क्वेरी सर्वर पर घटनाएँ फैलाती है; हर घटना baseEventId से स्रोत तक जाती है। महीने से बाहर dayOfMonth अंतिम दिन पर सीमित होता है। गणना सर्वर का स्थानीय समय क्षेत्र उपयोग करती है।
नामित कैलेंडर और साझाकरण
उपयोगकर्ता वैकल्पिक रंग के साथ 20 नामित कैलेंडर बना सकता है। कार्यक्रम का वैकल्पिक calendarId होता है; बिना ID निजी डिफ़ॉल्ट दायरे में रहता है।
साझा अनुमति मॉडल: read देखना देता है, write बनाना/संपादन भी। सहयोगी का कार्यक्रम कैलेंडर मालिक के खाते में सहेजा जाता है, इसलिए कोटा, हटाना और संग्रह मालिक के हैं। हर अनुरोध फिर अधिकृत होता है; अनुमति वापस लेना अगली पढ़ाई में छिपाता है। कैलेंडर हटाने पर कार्यक्रम मालिक के डिफ़ॉल्ट दायरे में अलग हो जाते हैं और अनुमतियाँ हटती हैं।
अनुस्मारक
कार्यक्रम reminderMinutes (14 दिन तक) रख सकता है। ऑटोमेशन शेड्यूलर का लीज़्ड टिक समय आए अनुस्मारक खोजकर मालिक को calendar-reminder भेजता है; प्रति घटना तुलना-और-सेट क्रिया एक बार चलना सुनिश्चित करती है।
ICS आयात और निर्यात
GET /api/calendar/export?calendarId= RFC 5545 .ics डाउनलोड करता है: UTC समय, escape पाठ, मूल RRULE, VALARM। POST /api/calendar/import लिखने योग्य कैलेंडर में 2 MB / 1,000 कार्यक्रम तक लेता है। UTC/फ़्लोटिंग समय, पूरे दिन DATE, सरल FREQ संभाले जाते हैं; ठीक से न दिख सकने वाले INTERVAL, COUNT, UNTIL, EXDATE बिना पुनरावृत्ति आयात और छोड़े नियम के रूप में गिने जाते हैं।
मॉडल पहुँच
तीन टूल कॉल करने वाले की पहचान से चलते हैं: केवल पढ़ने वाला list_calendar_events, और स्वीकृति माँगने वाले create_calendar_event, delete_calendar_event।
API
सभी एंडपॉइंट प्रमाणीकरण चाहते हैं। पढ़ना अपने और साझा कार्यक्रम, लिखना स्वामित्व या write अनुमति चाहता है।
| विधि | पथ | उद्देश्य |
|---|---|---|
GET | /api/calendar/events?from=&to= | रेंज के विस्तृत कार्यक्रम |
POST | /api/calendar/events | कार्यक्रम बनाएँ |
PUT | /api/calendar/events/:eventId | कार्यक्रम अपडेट करें |
DELETE | /api/calendar/events/:eventId | कार्यक्रम हटाएँ |
GET | /api/calendar/calendars | अपने और साझा कैलेंडर |
POST | /api/calendar/calendars | नामित कैलेंडर बनाएँ |
PUT | /api/calendar/calendars/:id | नाम या रंग बदलें |
DELETE | /api/calendar/calendars/:id | कैलेंडर हटाएँ, कार्यक्रम अलग करें |
GET | /api/calendar/export | ICS निर्यात |
POST | /api/calendar/import | ICS आयात |
from/to epoch-मिलीसेकंड सीमा एक अनुरोध में अधिकतम 13 माह है। उपयोगकर्ता 2000 कार्यक्रम रख सकता है; शीर्षक 200 और नोट 10,000 अक्षर।