{"openapi":"3.1.0","info":{"title":"桃子冰粉 AI 外接包 Connector","version":"0.1.0","description":"面向 Agent 平台和外部 AI 客户端的只读公开数据工具接口原型。"},"servers":[{"url":"https://testaitest.pages.dev"}],"paths":{"/connector/tools/daily-overview":{"post":{"operationId":"get_daily_overview","summary":"获取每日总览","description":"返回桃子冰粉 ETF 看板的公开每日总览、证据、反面信号和数据边界。","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","description":"原型阶段可传 demo-active；正式版改为 OAuth 或 API Key。"},"date":{"type":"string","description":"可选日期，YYYY-MM-DD。原型阶段只用于审计回显。"},"platform":{"type":"string","description":"调用方平台，例如 kimi、qwen、yuanbao、workbuddy、coze、chatgpt、claude。"},"question_text":{"type":"string","description":"可选。平台传入的用户问题原文或工具调用上下文，正式版用于问题意图分析。"},"question_intent":{"type":"string","description":"可选。平台或调用方整理后的问题意图，例如 daily_overview、wangwang_signal、data_freshness。"}}}}}},"responses":{"200":{"description":"工具调用成功或返回可读状态。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResponse"}}}},"403":{"description":"订阅无效、到期、暂停或超频。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResponse"}}}}}}},"/connector/tools/wangwang-signal":{"post":{"operationId":"get_wangwang_signal","summary":"获取汪汪队信号","description":"返回公开 ETF 数据中的汪汪队/承接相关观察，只描述事实和边界，不给交易建议。","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","description":"原型阶段可传 demo-active；正式版改为 OAuth 或 API Key。"},"date":{"type":"string","description":"可选日期，YYYY-MM-DD。原型阶段只用于审计回显。"},"platform":{"type":"string","description":"调用方平台，例如 kimi、qwen、yuanbao、workbuddy、coze、chatgpt、claude。"},"question_text":{"type":"string","description":"可选。平台传入的用户问题原文或工具调用上下文，正式版用于问题意图分析。"},"question_intent":{"type":"string","description":"可选。平台或调用方整理后的问题意图，例如 daily_overview、wangwang_signal、data_freshness。"}}}}}},"responses":{"200":{"description":"工具调用成功或返回可读状态。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResponse"}}}},"403":{"description":"订阅无效、到期、暂停或超频。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResponse"}}}}}}},"/connector/tools/data-freshness":{"post":{"operationId":"get_data_freshness","summary":"获取数据新鲜度","description":"返回当前快照日期、来源状态和下一步观察边界，适合外部 AI 先确认数据是否更新。","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"token":{"type":"string","description":"原型阶段可传 demo-active；正式版改为 OAuth 或 API Key。"},"date":{"type":"string","description":"可选日期，YYYY-MM-DD。原型阶段只用于审计回显。"},"platform":{"type":"string","description":"调用方平台，例如 kimi、qwen、yuanbao、workbuddy、coze、chatgpt、claude。"},"question_text":{"type":"string","description":"可选。平台传入的用户问题原文或工具调用上下文，正式版用于问题意图分析。"},"question_intent":{"type":"string","description":"可选。平台或调用方整理后的问题意图，例如 daily_overview、wangwang_signal、data_freshness。"}}}}}},"responses":{"200":{"description":"工具调用成功或返回可读状态。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResponse"}}}},"403":{"description":"订阅无效、到期、暂停或超频。","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ToolResponse"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"原型阶段使用 demo-active；正式版使用 OAuth 或订阅 API Key。"}},"schemas":{"ToolResponse":{"type":"object","required":["ok","tool","request_id"],"properties":{"ok":{"type":"boolean"},"tool":{"type":"string"},"request_id":{"type":"string"},"subscription_id":{"type":"string"},"watermark_id":{"type":"string"},"snapshot_version":{"type":"string"},"as_of_date":{"type":"string"},"state":{"type":"string"},"message":{"type":"string"},"data":{"type":"object"},"compliance":{"type":"object"},"subscription_tool_call_event":{"$ref":"#/components/schemas/SubscriptionToolCallEvent"}}},"SubscriptionToolCallEvent":{"type":"object","required":["event_type","event_id","request_id","tool","platform","status"],"properties":{"event_type":{"type":"string"},"event_id":{"type":"string"},"request_id":{"type":"string"},"subscription_id":{"type":"string"},"watermark_id":{"type":"string"},"platform":{"type":"string"},"tool":{"type":"string"},"question_intent":{"type":"string"},"user_question_text":{"type":"string"},"tool_arguments":{"type":"object"},"status":{"type":"string"},"failure_reason":{"type":"string"},"snapshot_version":{"type":"string"},"as_of_date":{"type":"string"},"subscription_blocked":{"type":"boolean"},"quota_blocked":{"type":"boolean"},"compliance_blocked":{"type":"boolean"}}}}}}