캘린더 구독
링크로 구독하는 다른 캘린더. 그 일정은 내 캘린더에 읽기 전용으로 표시됩니다.
5개 호출을 워크스페이스에 실제로 실행합니다.
POST /calendar/subscriptions
링크로 구독하는 다른 캘린더. 그 일정은 내 캘린더에 읽기 전용으로 표시됩니다.
구독하기
calendar:write가 필요합니다. url은 iCalendar 파일로 가는 https, http 또는 webcal 링크이고, name의 기본값은 캘린더가 스스로 붙인 이름입니다.
curl -X POST "$OE/calendar/subscriptions" -H "$AUTH" -H 'content-type: application/json' -d '{ "url": "webcal://example.com/holidays.ics", "color": "green" }'{ "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"}캘린더는 바로 불러오고, 그 뒤로는 약 30분마다 불러옵니다. GET /calendar/subscriptions는 구독을 나열하고, PATCH /calendar/subscriptions/{id}는 구독의 이름이나 color를 바꾸며, POST /calendar/subscriptions/{id}/refresh는 지금 다시 불러오고, DELETE /calendar/subscriptions/{id}는 구독을 그 일정과 함께 삭제합니다.
캘린더로 응답하지 않는 링크는 422 calendar_subscription_unreadable, 이미 구독 중인 링크는 409 calendar_subscription_exists, 마지막으로 불러온 뒤 1분 안에 하는 새로 고침은 429 calendar_subscription_refresh_too_soon입니다. 불러오기가 실패하는 동안 status는 failing이 되고, 10번 연속으로 실패하면 stopped가 되며, 이유는 lastError에 담깁니다.
구독에서 온 일정에는 그 구독의 subscriptionId가 붙으며 바꿀 수 없고, 바꾸려 하면 403 event_read_only입니다. 일부 주소나 도메인으로 제한된 키는 422 capability_unsupported입니다.