遇见数据集

Add to calendar

收藏
RapidAPI2026-07-25 更新2026-07-28 收录
官方服务:

资源简介:

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 布尔值 默认为 falsetruestartend 为纯日期
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。
  • 认证/配额错误(401403429):由 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
二维码
社区交流群
二维码
科研交流群
商业服务