API文档 - 调-需求调研智能体

调-需求调研智能体的REST API接入文档

调-需求调研 - API接入

通过REST API将调-需求调研智能体的能力集成到您的系统中。所有API均通过AspClaw Gateway六道闸安全链保护。


认证方式

所有API请求需要在Header中携带API Key:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

API Key可在开发者中心申请。


API端点

POST /api/v1/survey/start

创建调研会话

请求示例: {"scene_type": "factory", "area_sqm": 5000}

POST /api/v1/survey/dialogue

发送对话消息

请求示例: {"session_id": "xxx", "message": "..."}

GET /api/v1/survey/report/{id}

获取调研报告

请求示例: 返回结构化需求报告JSON

POST /api/v1/survey/validate

需求完整性校验

请求示例: {"session_id": "xxx"}


速率限制

套餐 请求频率 日调用量
免费版 10次/分钟 100次/天
专业版 60次/分钟 10,000次/天
企业版 不限 不限

错误码

错误码 说明 处理建议
200 成功 -
400 请求参数错误 检查请求体格式
401 认证失败 检查API Key
429 超出速率限制 降低请求频率
500 服务内部错误 重试或联系支持

SDK与支持

申请API Key -> | 联系支持 ->