跳转到主要内容
POST
创建标注

授权

Authorization
string
header
必填

每个请求都通过 API Key 认证:Authorization: Bearer {API_KEY}。应用接口使用应用 API Key,知识库接口使用知识库 API Key(快速开始)。

API Key 应保存在服务端,切勿嵌入客户端代码。缺失或无效的 Key 会返回 HTTP 401unauthorized)。

请求体

application/json

创建新标注的请求体。

question
string
必填

应用用来匹配用户输入的问题文本。

answer
string
必填

命中该标注时返回的答案。

响应

201 - application/json

标注创建成功。

id
string<uuid>

标注唯一标识符。

question
string | null

触发该标注的问题文本。

answer
string | null

标注被匹配时返回的预定义回答。

hit_count
integer | null

该标注被匹配并作为回复返回的次数。

created_at
integer<int64> | null

创建时间戳(Unix 纪元秒)。