BM 绑定与解绑工单

本接口接收个人广告账户与客户 BM 的绑定、解绑需求。当前阶段只校验、保存并排队，实际绑定与解绑执行流程尚未启用。 HTTP 202 表示工单已保存，不代表操作完成。

接口地址

操作	方法	地址
提交绑定	POST	https://api.supertopads.com/v1/orders/bm/bind
提交解绑	POST	https://api.supertopads.com/v1/orders/bm/unbind

两者均要求 Content-Type: application/json，沿用接入说明中的来源 IP 白名单。

请求结构

{
  "account_demand_id": 495756,
  "account_code": "123456789012345",
  "busine_code": "987654321012345"
}

示例账户 ID 仅为格式示意，提交时必须换成实际账户 ID。

字段	类型	说明
account_demand_id	integer	客户请求 ID，正整数，不超过 9007199254740991；所有外部工单共用唯一范围
account_code	string	我们系统中个人账户所持有的广告账户 ID，1–32 位数字字符串，首位非零；不是个人 FB UID，也不是中台内部 UUID
busine_code	string	客户提供的外部 BM ID，1–32 位数字字符串，首位非零；字段拼写固定为 busine_code

不要添加 act_ 前缀、空格或额外字段。外部 BM 不要求已登记在我们的中台；接收阶段仅检查其格式，不验证平台侧存在性或访问权限，这些将在执行阶段核验。

立即校验与错误

• 参数格式错误：HTTP 400，INVALID_EXTERNAL_BM_ORDER。
• 广告账户不在我们系统的个人账户记录中：HTTP 404，AD_ACCOUNT_NOT_FOUND。
• 广告账户 ID 对应多条个人账户记录：HTTP 409，AD_ACCOUNT_AMBIGUOUS，需由我们核对资产资料。
• 请求 ID 已用于不同参数或不同操作：HTTP 409，ACCOUNT_DEMAND_ID_CONFLICT。

以上错误均不会创建新工单。接收工单不会直接修改账户与 BM 的实际关联；解绑是否存在可撤销的授权，由后续执行流程核验。

成功响应

HTTP 202：

{
  "order_id": "c76153b5-cb46-4c8b-aa8a-6e12708e611f",
  "status": "PENDING"
}

请保存我们的 order_id。网络超时后，使用相同请求 ID、相同操作和相同参数重试，会返回同一工单 ID 和当前状态。

绑定和解绑是两个不同请求，必须使用不同的 account_demand_id；原有账户需求接口也不能复用这两个请求 ID。

查询状态

绑定、解绑与原有账户需求统一使用状态查询接口，二选一：

GET /v1/orders/status?order_id=c76153b5-cb46-4c8b-aa8a-6e12708e611f

GET /v1/orders/status?account_demand_id=495756

响应仍为 order_id、account_demand_id 和 status。公开状态只有 PENDING、PROCESSING、COMPLETED。只有 COMPLETED 表示业务已完成。