Add to calendar
收藏官方服务:
资源简介:
Send event details, get back ready-to-use "add to calendar" links for Google Calendar, Outlook.com, Office 365, and Yahoo Calendar — plus a downloadable RFC 5545 .ics file. No accounts, no OAuth, no state. One request in, links out.
创建时间:
2026-07-25
原始信息汇总
数据集概述:Add-to-Calendar API
简介
该API能够将事件详情转换为可直接使用的"添加到日历"链接,支持 Google Calendar、Outlook.com、Office 365 和 Yahoo Calendar,同时生成符合 RFC 5545 标准的 .ics 文件。API 无需 OAuth、日历权限或用户账户,且不存储任何数据。
核心功能
- 提供两个端点:
POST /links:接收 JSON 格式的事件详情,返回所有四个日历提供商的链接以及完整的.ics文件内容(以字符串形式返回)。GET /ics:使用查询参数传递相同字段,直接返回日历文件(Content-Type: text/calendar; charset=utf-8),便于嵌入邮件或网页供用户下载。
- 自动处理时区偏移,将时间标准化为 UTC。
- 处理 iCalendar 规范中的复杂要求,如 CRLF 换行、75 字节行折叠、多字节字符避免分割、转义逗号/分号/换行符,以及全天的独占结束日期等。
请求参数(POST /links)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
title |
字符串 | 是 | 事件名称,最多 500 字符 |
start |
字符串 | 是 | ISO 8601 日期时间,支持时区偏移(例如 2026-08-01T14:00:00-07:00);全天事件使用 YYYY-MM-DD 格式 |
end |
字符串 | 否 | 格式同 start,不能早于 start |
allDay |
布尔值 | 否 | 默认为 false;true 时 start 和 end 为纯日期 |
description |
字符串 | 否 | 最多 5000 字符 |
location |
字符串 | 否 | 最多 1000 字符 |
url |
字符串 | 否 | 事件关联的链接,最多 2000 字符 |
响应字段(POST /links)
google:Google Calendar 事件创建链接outlook:Outlook.com 链接(个人 Microsoft 账户)office365:Office 365 链接(工作/学校账户)yahoo:Yahoo Calendar 事件创建链接ics:完整的.ics文件内容(字符串,非 URL)
错误处理
- 验证错误(
400):返回 JSON 格式{ "error": "..." },指明具体问题(如缺少必填字段、时间顺序错误、字段超长等)。 - 路径错误(
404):未知路径。 - 方法错误(
405):/links仅接受 POST,/ics仅接受 GET。 - 认证/配额错误(
401、403、429):由 RapidAPI 网关返回,使用message字段(如"You are not subscribed to this API.")。
限制与注意事项
- 每次请求仅支持一个事件,不支持重复事件(
RRULE)。 - 不进行时区数据库查询:时间根据提供的偏移量标准化为 UTC,需传递明确偏移量(如
-07:00),而非裸本地时间。 - Yahoo Calendar 的 URL 格式未公开文档化:API 使用长期使用的传统参数约定,经验证可工作,但 Yahoo 可能随时更改。
- 无状态:不存储任何事件数据,无法检索、编辑或查看历史。
定价
- BASIC:$0.00/月
- PRO:$10.00/月
创建者
- 由 Kevin Lauer 创建
- 订阅者数量:1
- 类别:Events




