伙伴云OpenAPI
  1. 表格数据
伙伴云OpenAPI
  • 开发指南
    • 开发前必读
    • 申请 API Key
    • 基本概念介绍
    • 数据筛选器
    • 更新日志
  • 工作区
    • 获取工作区列表
      GET
    • 获取工作区成员列表
      POST
  • 表格数据
    • 获取表格列表
      POST
    • 获取表格配置
      POST
    • 查询数据列表
      POST
    • 获取数据详情
      POST
    • 创建数据
      POST
    • 更新数据
      PUT
    • 删除数据
      DELETE
    • 批量创建数据
      POST
    • 批量更新或创建数据
      PUT
    • 批量删除数据
      DELETE
  • 数据仓库数据
    • 获取数据仓库表格列表
      POST
    • 获取数据仓库表格配置
      POST
    • 查询数据列表
      POST
    • 获取数据详情
      POST
    • 批量创建数据
      POST
    • 批量更新数据
      PUT
    • 根据数据ID列表更新成相同数据
      PUT
    • 批量删除数据
      DELETE
  • 流程
    • 获取流程列表
    • 查询流程实例列表
    • 获取流程实例详情
    • 获取流程实例的执行记录
    • 查询流程任务列表
    • 获取流程任务详情
  • 文件
    • 批量获取文件详情
    • 上传文件
  • 订阅
    • 订阅事件概述
    • Encrypt Key 加解密
    • 订阅回调事件
    • 添加订阅
    • 取消订阅
    • 获取订阅列表
  • 服务商
    • 获取 access_token
    • 获取服务商的 api_key
    • 获取服务商信息
    • 设置订阅回调地址
    • 获取订阅回调地址
  1. 表格数据

批量创建数据

POST
https://api.huoban.com/openapi/v1/items
在指定表格中创建新数据,支持传入数据的数组做批量创建,单次最多批量创建 100 条数据。
注意:该接口为异步调用,将通过回调事件推送执行结果,详见”订阅回调事件“。

请求参数

Header 参数
Open-Authorization
string 
必需
授权的 API Key
默认值:
Bearer {{API_KEY}}
Body 参数application/json
table_id
string 
表格ID或别名
必需
items
array[object (字段提交) {1}] 
数据
必需
{field_id}
必需
只枚举出需要提交的字段,Key为字段ID或别名,并根据字段的数据类型(data_type)提交对应类型的字段值
callback_field_ids
array[string]
结果回调回传字段
可选
如果配置了该值,则回调结果中会返回配置的字段的值,最多设置3个字段ID
<= 3 items
示例
{
  "table_id": "{{TABLE_ID}}",
  "items": [
    {
      "2200000137810772": "单行文本1",
      "2200000137811680": "多行文本1\n多行文本1\n多行文本1"
    },
    {
      "2200000137810772": "单行文本2",
      "2200000137811680": "多行文本2\n多行文本2\n多行文本2"
    },
    {
      "2200000137810772": "单行文本3",
      "2200000137811680": "多行文本3\n多行文本3\n多行文本3"
    }
  ],
  "callback_field_ids": [
    "2200000137810772"
  ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.huoban.com/openapi/v1/items' \
--header 'Open-Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "table_id": "",
    "items": [
        {
            "2200000137810772": "单行文本1",
            "2200000137811680": "多行文本1\n多行文本1\n多行文本1"
        },
        {
            "2200000137810772": "单行文本2",
            "2200000137811680": "多行文本2\n多行文本2\n多行文本2"
        },
        {
            "2200000137810772": "单行文本3",
            "2200000137811680": "多行文本3\n多行文本3\n多行文本3"
        }
    ],
    "callback_field_ids":["2200000137810772"]
}'

返回响应

🟢200成功
application/json
Body
code
integer 
错误码
必需
0 为成功,小于 10000 为系统异常,其他为业务异常
message
string 
错误信息
必需
具体的错误原因,code 为 0 时返回“success”
data
object 
返回数据
必需
返回具体数据的结构
items
array [object {1}] 
数据列表
必需
meta
object 
元数据
必需
用来描述返回数据原始信息
trace_id
string 
请求ID
必需
每次请求接口会返回唯一的ID
示例
{
  "code": 0,
  "message": "success",
  "data": {
    "items": [
      {
        "item_id": 2300002262855982
      },
      {
        "item_id": 2300002262855983
      },
      {
        "item_id": 2300002262855984
      }
    ]
  },
  "meta": {
    "trace_id": "1677728211249166"
  },
  "version": "v1.0.1"
}
上一页
删除数据
下一页
批量更新或创建数据
Built with