Camera API

Camera API

通过探鸽云端 API 完成设备解析、接口选路、云事件归纳和截图轮询，并将结果整理成面向用户的答案。优先返回设备状态、事件摘要和图片内容，不直接回传原始签名图片 URL 或未整理的接口响应。

硬性约束

认证与地址

• 所有请求都使用 https://openapi-cn01.tange365.com/。
• 所有请求都带上以下请求头：

Authorization: Bearer $TIVS_API_KEY
X-Tg-App-Id: $TIVS_APP_ID
Accept-Language: zh-CN
X-Tg-Platform: pc
Content-Type: application/json
X-Tg-SDK-VERSION: 216

• 只使用环境变量 TIVS_API_KEY 和 TIVS_APP_ID。不要在技能内容、代码或回复里硬编码任何凭据或用户私密信息。
• 默认按上面的 X-Tg-Platform: pc 发请求；如果当前运行环境已经通过 SDK 自动注入 web，沿用运行时默认值，不要同时发送两个不同的 X-Tg-Platform。
• 这些都是云端 API。通过局域网模式添加、直连的设备，不适用本技能里的云端查询接口。
• https://openapi-cn01.tange365.com/ 只是 API 服务地址，不是创建 AppID 或 api_key 的入口页面。

凭据缺失处理

• AppID / api_key 的获取页面可能因客户 APP 名称、APP 账号体系不同而不同，不要假设所有用户共用同一个入口页面。
• 只能按用户当前使用的 APP 名称来识别对应页面，不要尝试按品牌名推断，因为同一个 APP 里可能包含多个品牌。
• 已知映射：
  • icam365 APP 账号：https://skill.webcamapp.cc/icam365/api-key
  • wosee APP 账号：https://skill.webcamapp.cc/wosee/api-key
• 如果首次聊天里已经提到当前 APP 对应的获取页面，把这个页面记为固定上下文，后续缺少 TIVS_API_KEY 或 TIVS_APP_ID 时优先复用。
• 缺少凭据时，不要让用户直接把他人的密钥贴给你，也不要猜测或替换成 API Base URL、demo 地址、文档地址，更不要臆造一个 APP 页面 URL。
• 标准提示动作：
  1. 明确指出缺少的是 TIVS_API_KEY、TIVS_APP_ID，还是两者都缺失。
  2. 先确认用户当前使用的 APP 名称；如果上下文里已经明确，就不要重复追问。
  3. 若 APP 命中已知映射，直接给出对应的 API Key 获取页面。
  4. 若 APP 未命中已知映射，但首次聊天里给过该 APP 页面，就复用首次聊天里的页面。
  5. 若 APP 未知或当前上下文里没有该 APP 页面，就明确让用户补充“当前使用的 APP 名称”或提供该 APP 的官方 API Key 获取页面。