技能介绍

要解决什么问题

百数（Baishu）是低代码表单与应用平台，业务数据落在各应用的 entry 里。若要做数据迁移、与 ERP/BI 的双向同步，或按条件批量改删，只能依赖开放平台 OpenAPI，而不是在控制台逐条操作。难点在于：同一租户有独立 Base URL、字段要用别名（widget）传值、筛选器 filter 的 method 与 rel/cond 结构不直观，且接口每秒最多 5 次（超限返回 4004）。

技能如何帮你对接

本技能把官方接口整理成三块能力，并指向内置 Python 封装 scripts/baishuyun_api.py：

应用接口：查应用/表单列表、用 POST .../widgets 拉字段结构（name、type、title、widget），便于建立外部字段与百数别名的映射。
表单数据接口：单条与批量的增删改查；data 分页（limit≤300、skip）、fields 投影、sort、按 data_id 列表查询；data_count 先算总量；filter 支持 eq/ne/empty/gt/like 等；可选 is_start_workflow、is_start_event。
文件接口：upload_file 通过 URL 上传，返回的 url 可写入附件/图片字段。

文档里还给出了常见字段类型传值格式（成员、地址、子表单等）和三条 SOP：外部→百数迁移、百数→外部分页导出、条件批量更新/删除。

边界与注意点

查询字段结构不支持分割线与关联查询字段。
所有请求 Header 需 Authorization: Bearer YOUR_APIKEY；4001 参数、4003 无权限、4005 数据不存在等需按错误码处理。
批量写入建议每批 ≤100；附件需先上传再填数据结构 [{"name","url"}]。