添加表数据

支持通过该 API 接口，单次将最多 1000 行数据添加到指定的 Agent 的数据表中，以便在对话中使用和查询。

注意：

开启了唯一性字段的 value 长度禁止超过256字符。

未开启唯一性字段的 value 长度禁止超过4294967295字符(实际上受限于网络问题，建议控制数据长度)。

通过接口传输的数据将被转换为CSV数据，CSV文件大小禁止超过 10 M。

请求方式

POST

调用地址

https://api-${endpoint}.gptbots.ai/v1/database/import/records

调用验证

详情参见 API 概述的鉴权方式说明。

请求

请求示例

curl -X 'POST' 'https://api-${endpoint}.gptbots.ai/v1/database/import/records' \ -H 'Authorization: Bearer ${API Key}' \ -H 'Content-Type: application/json' \ -d '{ "table_id": "673af861ed69656ac0895b07", "records": [ { "id": "7424489", "name": "4455566777777" }, { "id": "7852549", "name": "446656677665" } ] }'

                      
                      curl -X 'POST' 'https://api-${endpoint}.gptbots.ai/v1/database/import/records' \
-H 'Authorization: Bearer ${API Key}' \
-H 'Content-Type: application/json' \
-d '{
    "table_id": "673af861ed69656ac0895b07",
    "records": [
        {
                "id": "7424489",
                "name": "4455566777777"
        }, 
        {
                "id": "7852549",
                "name": "446656677665"
        }
    ]
}'

此代码块在浮窗中显示

请求头

字段	类型	描述
Authorization	Bearer ${API Key}	使用 Authorization: Bearer ${API Key}进行调用验证，请在 API 密钥页面获取密钥作为 API Key。
Content-Type	application/json	数据类型，取值为 application/json。

请求体

字段	类型	必填	描述
records	list	是	导入的数据集合。
table_id	string	是	表id。

注意：

当数据表中存在唯一性字段时，records 中必须携带所有的唯一性字段。

records 中携带的唯一性字段的值禁止重复、禁止为空、禁止在库中已存在，否则将报错并丢弃。

响应

响应示例

"673e9cda9f7bc178002dbd9c"

                      
                      "673e9cda9f7bc178002dbd9c"

此代码块在浮窗中显示

成功响应

字段	类型	描述
code	int	消息的类型编码。
message	string	消息描述。
data	object	本次添加表数据的任务ID，仅会返回1个ID。

失败响应

字段	类型	描述
code	int	错误码。
message	string	错误详情。

错误码

Code	Message
40000	参数错误
50000	系统内部错误