注意事项
签名、账号格式、回调可达性和调用频率是最常见的接入问题。
接入约束
请按下列规则接入,避免签名失败或回调收不到。
- 签名字段必须与 Body 完全一致(含 timestamp 字符串形式)。Body 改了必须重签。
- account 支持手机号、邮箱、支付宝登录号、UID;手机号会按支付宝 phone_id 发放。
- 异步通知可能延迟数秒;刚发放成功时本地可能暂时没有 user_id,以回调为准。
- 请勿将 token 写在前端或公开仓库。
- 请控制调用频率,避免触发限流。
- callback_url 必须公网可达;不要配置成平台统一回调地址本身,否则无法二次转发。