对外接口库存提取对接提取库存-作废


对外接口库存提取对接提取库存 公开

使用场景

已支持:
1.通过礼品编号提取

API描述

API描述:通过礼品编号提取

请求流程

  1. 在超8平台中申请第三方系统的应用Access Key和密钥(线下)。
  2. 第三方系统根据应用Access Key和密钥向系统发起Access Token申请【如何获取token】。
  3. 三方系统调用防伪领域服务的开放接口进行数据对接。

具体请求请参阅:
请参阅 请求流程

请求信息

协议 HTTPS
请求方法 POST
请求路径 /marketing/v1/open-operate-gift/set-extract-stock

header头

请参阅 通用请求头

请求参数

名称类型是否必须默认值备注其他信息
thirdExtractIdstring必须第三方提取主键id
reasonstring非必填提取原因
giftNostring必填礼品编号
extractCount数值必填数量

返回消息体

名称 类型 是否必须 默认值 备注 其他信息
code integer 非必须 错误码 format: int32
data string 非必须 返回值
message string 非必须 消息内容
timestamp integer 非必须 时间戳 format: int64
traceId string 非必须 链路追踪ID

请求示例

请求地址:{URL}/v1/open-operate-gift/set-extract-stock
Post参数:
{
    "thirdExtractId":"dddddd",
    "giftNo":"zstyhb",
    "reason":"dddddd",
    "extractCount":"0.3"
}

响应示例

{
    "code": 200,
    "message": "success",
    "data": "",
    "timestamp": 1679565957862,
    "traceId": "221198c7-ccf5-444e-a088-12aae8d995fd"
}

异常示例

{
  "code": 135630001,
  "message": "参数错误",
  "traceId":"xxxxxx",
  "timestamp": 1679368912568
}

返回码

返回码 描述 解决方案
21211080 礼品不存在
21215439 未获取到企业号数据
21211079 企业礼品库存余额不足,不允许提取
21210023 企业礼品信息查询失败,请刷新重试
21210005 系统异常,请联系管理员!

guanhengbing 2024年12月18日 17:31 38 收藏文档