收银员登录

收银员通过工号和密码登录终端，登录成功后获取会话标识，后续请求需在 Header 中携带会话信息。

请求接口

POST /open/cashier/user/login

通用参数

请求签名：Authorization Header，详见签名方法
客户端信息：Ikudot-Cashier-Client Header，详见客户端信息

请求参数

参数	必填	类型	说明
employee_no	是	String	工号
password	是	String	密码

响应参数

参数	类型	说明
session	String	会话标识，后续请求需通过 Header 携带
login_time	String	登录时间，格式 `yyyy-MM-dd HH:mm:ss`
expire_time	String	登录失效时间，格式 `yyyy-MM-dd HH:mm:ss`

请求示例

{
  "employee_no": "EMP001",
  "password": "123456"
}

响应示例

{
  "code": 0,
  "msg": "success",
  "data": {
    "session": "sess_abc123def456",
    "login_time": "2026-05-07 09:00:00",
    "expire_time": "2026-05-07 18:00:00"
  }
}

信息

登录成功后，后续需签名的接口请求需在 Ikudot-Cashier-Client Header 中携带 session 值：

Ikudot-Cashier-Client: session="sess_abc123def456"

登录失效提醒

当会话过期时，请求任意接口将返回响应码 -10012（登录已失效），客户端应引导收银员重新登录。响应示例：

{
  "code": -10012,
  "msg": "登录已失效",
  "data": null
}

收到该响应码后，请立即跳转至登录页面，切勿使用已失效的 session 继续发起请求。

请求接口​

通用参数​

请求参数​

响应参数​

请求示例​

响应示例​