错误码

失败响应的 code 字段为机器可读错误码,message 为可读说明。

code	HTTP	说明
OK	200	成功
VALIDATION_ERROR	400	参数校验失败
TEMPLATE_VAR_MISSING	400	模板变量缺失
INVALID_API_KEY	401	API Key/Secret 无效或停用
MESSAGE_NOT_FOUND	404	消息不存在
TEMPLATE_NOT_FOUND	404	模板不存在或未批准
CUSTOMER_NOT_BOUND	409	客户未绑定 LINE
CUSTOMER_UNFOLLOWED	409	客户未加官方账号好友,无法推送
IDEMPOTENCY_CONFLICT	409	相同幂等键但请求内容不同
QUOTA_EXCEEDED	429	本月消息配额已用尽
INTERNAL_ERROR	500	服务端异常

错误响应示例

{
  "code": "CUSTOMER_NOT_BOUND",
  "message": "客户未绑定 LINE",
  "requestId": "req_...",
  "data": null
}

建议处理

• CUSTOMER_NOT_BOUND / CUSTOMER_UNFOLLOWED:引导客户先完成 LINE 绑定 / 加官方账号好友。
• QUOTA_EXCEEDED:联系平台方升级套餐或等待下个计费周期。
• INVALID_API_KEY:检查 Key/Secret 是否正确、是否被停用。
• 排查问题时请提供响应里的 requestId。