常见问题
更新时间：2026.08.21配置相关
Q：部分用户 plan_ids 好像被无故清空？
A：通常是调用 批量设置用户联合投放配置API 前未先查询合并，直接传了不完整 plan_ids。请排查所有调用批量设置的代码路径。
签名相关（业务特有）
签名验签通用说明见品牌API如何签名和验签 。联合投放额外注意：
Q：调用批量查询用户联合投放配置 一直 SIGN_ERROR？
A：除通用签名问题外，GET 接口签名时 URL 路径必须包含与实际请求完全一致的完整 query string。
单用户级错误码（HTTP 200 也可能出现）
Q：单用户级错误码有哪些？
A：参考下表：
单用户 error_code | 出现接口 | 含义 | 处理建议 |
|---|---|---|---|
USER_NOT_FOUND | 批量查询 / 批量设置 | 用户不存在或无法识别 | 核对 identifier_type、OpenID 对应 appid 是否已绑定、手机号 MD5 是否为 32 位小写十六进制。少量用户可按业务阈值告警；大量失败优先查整批数据问题。 |
INVALID_PLAN_ID | 批量设置 | plan_id 不属于本品牌或不存在 | 核对 plan_ids中的投放计划ID是否来自运营下发或本品牌创建的，是否拼写错误或已失效。 建议本地维护一份「本品牌可用 plan_ids 清单」做校验。 |
RATELIMIT_EXCEEDED | 批量查询 / 批量设置 | 单用户级别限频 | 在批次维度指数退避重试 |
文档是否有帮助
