Belgelere geç
API

Takvim abonelikleri

Bağlantıyla abone olduğunuz ve etkinlikleri takviminizde salt okunur görünen diğer takvimler.

POST/calendar/subscriptions

5 çağrıdan herhangi birini çalışma alanınızda çalıştırır.

POST /calendar/subscriptions

Bağlantıyla abone olduğunuz ve etkinlikleri takviminizde salt okunur görünen diğer takvimler.

Abone olma

calendar:write gerektirir. url, bir iCalendar dosyasına giden bir https, http ya da webcal bağlantısıdır; name verilmezse takvimin kendine verdiği ad kullanılır.

curl
curl -X POST "$OE/calendar/subscriptions" -H "$AUTH" -H 'content-type: application/json' -d '{ "url": "webcal://example.com/holidays.ics", "color": "green" }'
Yanıt
{  "object": "calendar_subscription",  "id": "csb_8d3f0a2b9c4e41f7a6b5c2d1",  "name": "Public holidays",  "url": "https://example.com/holidays.ics",  "color": "green",  "status": "active",  "lastError": null,  "eventCount": 24,  "lastSyncedAt": "2026-10-10T12:00:03.000Z",  "lastFetchedAt": "2026-10-10T12:00:03.000Z",  "createdAt": "2026-10-10T12:00:01.000Z"}

Takvim hemen, ardından yaklaşık 30 dakikada bir okunur. GET /calendar/subscriptions abonelikleri listeler, PATCH /calendar/subscriptions/{id} birini yeniden adlandırır ya da color değerini değiştirir, POST /calendar/subscriptions/{id}/refresh birini hemen yeniden okur, DELETE /calendar/subscriptions/{id} ise aboneliği etkinlikleriyle birlikte kaldırır.

Bir takvimle yanıt vermeyen bir bağlantı 422 calendar_subscription_unreadable, zaten abone olduğunuz bir bağlantı 409 calendar_subscription_exists, son okumadan sonraki bir dakika içinde yapılan bir yenileme ise 429 calendar_subscription_refresh_too_soon döner. status, okumalar başarısız olduğu sürece failing, art arda on başarısızlıktan sonra stopped olur; nedeni lastError içindedir.

Bir abonelikten gelen etkinlikler onun subscriptionId değerini taşır ve değiştirilemez; bu 403 event_read_only döner. Bazı adreslerle veya alan adlarıyla sınırlı bir anahtar 422 capability_unsupported döner.

Referans