接入说明
一、接入流程
- 注册并登录浩价账号。
- 进入「我的 → API 密钥」，创建一把密钥并立即保存（明文只展示一次）。
- 用密钥调用「接口速览」中的任意接口，返回 code=0 即接入成功。
二、请求地址
所有开放接口统一使用：
https://www.caibijia.com/mallapi正式对接请使用上面的生产地址，灰度与测试环境地址不同。
三、鉴权方式
在请求头中携带 API Key：
| 请求头 | 必填 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer 加密钥，注意 Bearer 与密钥之间有一个空格 |
| Content-Type | POST 必填 | application/json（UTF-8 编码） |
请求示例：
curl -X GET "https://www.caibijia.com/mallapi/goodssku/dicversion" -H "Authorization: Bearer sk-****xxxx"密钥等同于账号密码，禁止写入前端代码、客户端安装包或公开仓库。发现泄露请立即在「API 密钥」页面禁用并重建。
四、通用约定
- 所有接口返回 HTTP 200，业务结果看响应体中的 code。
- GET 请求参数放在 URL 上；POST 请求体为 JSON。
- 分页参数统一为 current（页码，从 1 开始）与 size（每页条数）。
- 时间格式统一为
yyyy-MM-dd（日期）或yyyy-MM-dd HH:mm:ss（日期时间）。
取消