新建对话id
更新时间：2024-11-14
接口描述
该接口用于新建对话id，对话id的有效期为7天。超过之后可能无法使用，需要重新生成。
在线调试
百度智能云千帆提供了 API在线调试平台-示例代码 ，用于帮助开发者调试接口，平台集成快速检索、查看开发文档、查看在线调用的请求内容和返回结果、复制和下载示例代码等功能，简单易用。
权限说明
Authorization需要填写密钥。
接口定义
| Path | /v2/app/conversation |
|---|---|
| Method | POST |
| Content-Type | application/json |
| Authorization | 请求签名(此签名为应用工作台密钥) |
请求结构
POST /v2/app/conversation HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: authorization string
Content-Type: application/json
{
"app_id": "c5c7bfa8-97f6-48c0-97ac-689d1f6df6be"
}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 字段 | 类型 | 是否必须 | 说明 |
|---|---|---|---|
| app_id | string | 是 | 指定需要创建对话的app_id，来源于个人空间-应用-应用ID |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 字段 | 类型 | 必然存在 | 说明 |
|---|---|---|---|
| request_id | string | 是 | request_id |
| conversation_id | string | 是 | 本轮对话id，可以用于后续调用，有效期为7天。 |
请求curl 示例
curl --location 'https://qianfan.baidubce.com/v2/app/conversation' \
--header 'Authorization: Bearer authorization string' \
--header 'Content-Type: application/json' \
--data '{
"app_id": "85036d8f-239c-469c-b342-b62ca9d696f6"
}'正确响应示例
HTTP/1.1 200 OK
{
"request_id": "355a4f4e-a6d8-4dec-b840-7075030c6d22",
"conversation_id": "2370813b-5303-4a4f-b5cc-44f571121342"
}错误响应示例
HTTP/1.1 401
{
"request_id": "ae2225f7-1c2e-427a-a1ad-5413b762957d",
"code": "PermissionDeniedError",
"message": "没有权限"
}在线调试
AppBuilder提供了API调试平台,支持Python、Java、PHP、C#、Go、Node.js、C++ 7种主流语言示例代码自动生成。同时可以帮助开发者在线调试OpenAPI接口，支持查看在线调用的请求内容和返回结果、复制和下载示例代码等功能，简单易用。