对外接口库存提取对接提取库存 公开
使用场景
已支持:
1.通过礼品编号提取
API描述
API描述:通过礼品编号提取
请求流程
- 在超8平台中申请第三方系统的应用Access Key和密钥(线下)。
- 第三方系统根据应用Access Key和密钥向系统发起Access Token申请【如何获取token】。
- 三方系统调用防伪领域服务的开放接口进行数据对接。
具体请求请参阅:
请参阅 请求流程
请求信息
协议 | HTTPS |
---|---|
请求方法 | POST |
请求路径 | /marketing/v1/open-operate-gift/set-extract-stock |
header头
请参阅 通用请求头
请求参数
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
thirdExtractId | string | 必须 | 第三方提取主键id | ||
reason | string | 非必填 | 提取原因 | ||
giftNo | string | 必填 | 礼品编号 | ||
extractCount | 数值 | 必填 | 数量 |
返回消息体
名称 | 类型 | 是否必须 | 默认值 | 备注 | 其他信息 |
---|---|---|---|---|---|
code | integer | 非必须 | 错误码 | format: int32 | |
data | string | 非必须 | 返回值 | ||
message | string | 非必须 | 消息内容 | ||
timestamp | integer | 非必须 | 时间戳 | format: int64 | |
traceId | string | 非必须 | 链路追踪ID |
请求示例
响应示例
异常示例
返回码
返回码 | 描述 | 解决方案 |
---|---|---|
21211080 | 礼品不存在 | |
21215439 | 未获取到企业号数据 | |
21211079 | 企业礼品库存余额不足,不允许提取 | |
21210023 | 企业礼品信息查询失败,请刷新重试 | |
21210005 | 系统异常,请联系管理员! |