查询绑定状态
查询某个客户是否已绑定 LINE。发送消息前建议先确认。
GET /api/v1/merchant/customer/{customerExternalId}/line-binding
路径参数
| 参数 | 说明 |
|---|---|
customerExternalId | 你方系统的客户 ID |
成功响应 200
{
"code": "OK",
"message": "Success",
"requestId": "req_...",
"data": {
"customerExternalId": "C10086",
"bound": true,
"status": "ACTIVE",
"lineUserIdMasked": "U1a2****cd"
}
}
| 字段 | 说明 |
|---|---|
bound | 是否已绑定 |
status | ACTIVE(有效绑定)/ UNBOUND(未绑定) |
lineUserIdMasked | 掩码后的 LINE userId(不返回明文) |
未绑定时 bound=false、status="UNBOUND"、lineUserIdMasked=null。此接口为查询语义,不会报错。
示例
curl https://loma-dev.acorners.com/api/v1/merchant/customer/C10086/line-binding \
-H "X-Api-Key: lk_xxxx" -H "X-Api-Secret: xxxx"