commit ef35e0f27fe4a18a594b1881fce3e86ad5da3671 parent b7e9941ecde84a7ef0e2142d0a34c49f5e821f4d Author: Andreas Gruhler <andreas.gruhler@adfinis.com> Date: Thu, 13 Jun 2024 21:09:07 +0200 doc: document caldav curl requests Diffstat:
| A | docs/CALDAV.md | | | 24 | ++++++++++++++++++++++++ |
1 file changed, 24 insertions(+), 0 deletions(-)
diff --git a/docs/CALDAV.md b/docs/CALDAV.md @@ -0,0 +1,24 @@ +# CalDav requests + +## Request flow +CalDav request flow is as follows: +1. Get user principal +2. Find home set of user principal +3. Get calendar from home set +4. Fetch all events from calendar and sync availability + +To debug the flow, use the xml snippets from the code and curl. Example: +``` +curl -XPROPFIND -H "Content-Type: text/xml" \ + --data-binary "@query.xml" -u '$user:$pass' \ + https://caldav.gmx.net/begenda/dav/users/ +``` + +## Tested clients +* Kopano (with calendar discovery, use `HIVEDAV_CALDAV_HOST`) + - example: `HIVEDAV_CALDAV_HOST=https://mail.server.com:8443` + - https://documentation.kopano.io/user_manual_kopanocore/configure_caldav_clients.html +* GMX (with calendar direct uri to calendar, use `HIVEDAV_CALDAV_URI`) + - example: `HIVEDAV_CALDAV_URI=https://caldav.gmx.net/begenda/dav/00000000-0000-0000-0000-000000000000/calendar` + - https://hilfe.gmx.net/kalender/mobil/apps.html +