logo
开发者文档
搜索
添加表数据

添加表数据

支持通过该 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": [ { "values": { "id": "7424489", "name": "4455566777777" } }, { "values": { "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": [
        {
            "values": {
                "id": "7424489",
                "name": "4455566777777"
            }
        }, 
        {
            "values": {
                "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。

响应

响应示例

{ "code": 0, "message": "success", "data": [ "673e9cda9f7bc178002dbd9c" ] }
                      
                      {
    "code": 0,
    "message": "success",
    "data": [
        "673e9cda9f7bc178002dbd9c"
    ]
}

                    
此代码块在浮窗中显示

成功响应

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

失败响应

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

错误码

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