LOMA Merchant API

LOMA 为 Merchant 提供一组 HTTP API,用于通过 LINE 给已绑定的客户发送消息、查询发送状态与查询客户的 LINE 绑定状态。

• Base URL:https://loma-dev.acorners.com/api/v1/merchant
• 协议:HTTPS,Content-Type: application/json
• 鉴权:每个请求带 X-Api-Key + X-Api-Secret(见认证)

能力概览

能力	端点
发送消息(通知 / OTP 投递)	POST /message/send
查询消息发送状态	GET /message/{messageRequestId}
查询客户 LINE 绑定状态	GET /customer/{customerExternalId}/line-binding

统一响应结构

所有响应都是如下信封:

{
  "code": "OK",
  "message": "Success",
  "requestId": "req_...",
  "data": { }
}

• 成功:HTTP 200,code = "OK"。
• 失败:HTTP 4xx/5xx,code 为机器可读错误码(见错误码),data 可能为 null。

关于客户绑定

LOMA 以 customerExternalId(你方系统里的客户 ID)标识客户。发送消息前,该客户必须已与某个 LINE 用户绑定且仍是官方账号好友,否则会返回 CUSTOMER_NOT_BOUND / CUSTOMER_UNFOLLOWED。可用查询绑定状态接口预先确认。

OTP 说明

LOMA 只负责投递。OTP 的生成、有效期与校验都在你方系统完成 —— 你只需把生成好的验证码作为消息内容通过 POST /message/send(category=OTP)发送即可。