Clawdbot API批量处理需按五步操作：一、构造含id/method/path/body的JSON数组并置入batch字段；二、POST至/v1/batch端点，带Bearer认证；三、解析multipart/mixed响应，按boundary和Content-ID匹配结果；四、对非2xx响应依error.code分类处理；五、严格遵守50子请求、5MB大小等硬性限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您需要通过Clawdbot API对大量数据执行统一操作，例如批量创建、更新或删除资源，则必须正确配置和调用其批量处理（Batch Processing）端点。以下是使用该功能的具体步骤：
一、构造符合规范的批量请求体
Clawdbot API的批量处理要求所有子请求被封装在一个顶层JSON对象中，且每个子请求需明确指定HTTP方法、路径及可选的请求体。该结构确保服务端能按序解析并隔离执行各操作，避免相互干扰。
1、准备一个包含多个独立请求对象的数组，每个对象至少包含method和path字段；
2、为每个子请求添加id字段，用于后续响应中识别对应结果；
3、若子请求需携带数据，将有效载荷放入body字段，并确保其为合法JSON格式；
4、将整个数组作为batch字段的值，嵌入顶层JSON对象中；
5、设置Content-Type请求头为application/json。
二、使用POST方式调用/batch端点
Clawdbot API仅接受POST请求访问/batch路径，所有批量指令必须通过该唯一入口提交。服务端会同步返回整体状态，并在响应体中逐条反馈各子请求的执行结果。
1、构建完整URL，格式为https://api.clawdbot.com/v1/batch；
2、使用curl、Postman或编程语言HTTP客户端发起POST请求；
3、在请求体中填入已构造好的批量JSON结构；
4、添加Authorization请求头，值为Bearer后接有效API密钥；
5、发送请求并接收HTTP 200响应，确认批量任务已被接收。
三、解析多部分响应体（Multipart Response）
Clawdbot API对批量请求返回标准multipart/mixed格式响应，每一段对应一个子请求的结果，段间以唯一boundary分隔。客户端必须按此格式逐段提取并映射回原始id。
1、检查响应头中的Content-Type字段，确认其包含multipart/mixed及boundary参数；
2、按boundary字符串切分响应体为独立段落；
3、对每个段落提取Content-ID头，与原始请求中的id匹配；
4、读取段落主体内容，其为标准HTTP响应格式（含状态行、响应头与响应体）；
5、解析各段的状态码与JSON响应体，判断对应子请求是否成功。
四、处理子请求失败情形
单个子请求失败不会中断其余请求的执行，但需客户端主动识别错误状态并决定是否重试。Clawdbot不提供自动重试机制，全部由调用方控制。
1、扫描所有响应段，定位状态码非2xx的段落；
2、提取该段的响应体JSON，检查error字段是否存在；
3、若error.code为rate_limit_exceeded，则需等待60秒后再提交相同子请求；
4、若error.code为invalid_payload，则必须修正body内容并重新生成该子请求；
5、记录失败id及错误详情，用于日志归档或人工干预。
五、限制条件与边界校验
Clawdbot API对批量请求施加硬性约束，超出任一限制将导致整个请求被拒绝，返回HTTP 400错误。这些限制不可绕过，必须在构造前完成校验。
1、单次批量请求最多包含50个子请求；
2、整个请求体大小不得超过5MB；
3、每个子请求的path长度不可超过2048字符；
4、所有子请求的method仅允许为GET、POST、PUT、DELETE或PATCH；
5、若检测到任意子请求path以/../开头或包含空字节，则整批请求立即被拒绝。
