获取门店清单
查询当前租户下的门店清单,返回每个门店的 id 与 name。每个租户数据独立,无需额外传入租户标识。
POST/api/storelist
请求参数
| 名称 | 类型 | 描述 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
| token | String | 身份校验令牌 | 必填 | - | 由 获取访问令牌 获得 |
CURL
V1
curl --location --request POST 'https://open.xinduobang.cn/api/storelist' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=YOUR_TOKEN'
V2(appid 为 V2 版本)
curl --location --request POST 'https://open.xinduobang.cn/api/storelist' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'X-Timestamp: 1770000000' \
--header 'X-Nonce: 3f9c1a7b2e6d4058' \
--header 'X-Signature: <computed_hmac_sha256>' \
--data-urlencode 'token=YOUR_TOKEN'
信息
V2 签名算法及 X-Signature 计算方式见 V2 接入示例。下方接口 V2 示例均遵循相同规则,不再重复注释。
成功响应
{
"code": 0,
"msg": "success",
"data": [
{
"id": "1",
"name": "总部门店"
},
{
"id": "2",
"name": "上海分店"
}
]
}
| 字段 | 类型 | 说明 |
|---|---|---|
| id | String | 门店 ID |
| name | String | 门店名称 |
失败响应
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 200 | 非 0 | 业务错误 | 请检查 token 是否有效 |