赛事活动收录
在 AI 助手里发送赛事 URL，自动提取关键信息并收录到 OPC 公共池
POST /api/events/ingestInstall URL
https://demo.dev.coze.site/api/skills/opc-event-ingest/install个人集成与 API Key
把 OPC Skill 加载到你的 AI 助手
一个 Key，多种 Skill。把它配进任何能加载 SKILL.md 的 AI 客户端， 就可以调 OPC 所有的对外 API —— 全部用同一个鉴权。
需要先登录
Key 在用户注册时自动生成，登录后就可以在这里看到、复制、重置。 没账号？点右上角「登录/注册」一键创建。
当前可用的集成能力
一个 Key 适用下面所有 Skill；未来新增的能力会自动出现在这里
已上线
三步把 Skill 装上
通用流程，AI 客户端 / HTTP 客户端 / 自定义脚本都一样
1
复制 Key
登录后在上面的卡片里点「复制」拿到你的个人 API Key
2
选择安装方式
Skill 客户端：在客户端的 Skills 面板粘贴 Install URL，Key 配到 OPC_API_KEY 环境变量
HTTP / 脚本：把 Key 放到 X-API-Key 请求头里直接调 REST
3
开始使用
在 AI 助手里发送赛事 URL / 模型参数 / 数据，Skill 自动调用对应底层 API
底层 REST 接口（直调）
不想装 Skill？直接发 HTTP 请求也行，所有接口都用 X-API-Key 鉴权
示例：调用赛事收录接口
curl -X POST "https://demo.dev.coze.site/api/events/ingest" \
-H "Content-Type: application/json" \
-H "X-API-Key: <你的 Key>" \
-d '{
"title": "...",
"summary": "...",
"type": "hackathon",
"region": "online",
"organizer": "...",
"publishedAt": "2025-01-15T10:00:00+08:00",
"deadlineAt": "2025-02-20T23:59:59+08:00",
"externalUrl": "https://example.com/comp"
}'常见问题
Key 是怎么生成的？
用户注册时数据库 trigger 自动给每个账号生成一个 Key（opc_user_ 前缀 + 40 位 hex）。 你不需要做任何操作，登录后直接复制即可。
一个 Key 能用在哪几个场景？
任何已上线的 OPC Skill 都共享同一个 Key。当前可用的场景在「当前可用的集成能力」卡片里看得到； 未来新增能力也用同一个 Key，不用再开。
重置 Key 之后会发生什么？
旧 Key 立刻失效，已经配了旧 Key 的客户端会全部报 invalid_key。 软撤销：旧 Key 在数据库里标记为 revoked_at，记录保留可追溯，但不会再通过鉴权。
我能在多台设备上用同一个 Key 吗？
可以。Key 不绑设备，只要在每个客户端里配一次就行。建议给每个客户端起个名字（未来版本支持）。
Skill 是怎么分发的？我能自己做一个吗？
官方 Skill 直接在「技能广场」/skills 浏览与安装。 自有 Skill 可以去 /tools/publish-skill 上架（需 admin 权限）。
Key 泄漏了怎么办？
立刻点「重置 Key」，旧 Key 立即吊销，新 Key 旧客户端全部需要重新配置。