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

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

## 使用场景
>  已支持：
	1.通过礼品编号提取

## API描述
>  API描述：通过礼品编号提取

## 请求流程

>   1. 在超8平台中申请第三方系统的应用Access Key和密钥（线下）。
>   2. 第三方系统根据应用Access Key和密钥向系统发起**Access Token**申请【[如何获取token](https://developers.yesno.com.cn/doc/57/ "如何获取token")】。
>   3. 三方系统调用防伪领域服务的开放接口进行数据对接。

> 具体请求请参阅：
>请参阅  [请求流程](https://developers.yesno.com.cn/doc/56/ "请求流程")

## 请求信息

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

### header头
请参阅 [通用请求头](https://developers.yesno.com.cn/doc/56/ "请求头")

## 请求参数

<tr><td>thirdExtractId</td><td>string</td><td>必须</td><td></td><td>第三方提取主键id</td><td></td></tr>

<tr><td>reason</td><td>string</td><td>非必填</td><td></td><td>提取原因</td><td></td></tr>

<tr><td>giftNo</td><td>string</td><td>必填</td><td></td><td>礼品编号</td><td></td></tr>

<tr><td>extractCount</td><td>数值</td><td>必填</td><td></td><td>数量</td><td></td></tr>

</table>

## 返回消息体

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

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

## 响应示例

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

## 异常示例
```json
{
  "code": 135630001,
  "message": "参数错误",
  "traceId":"xxxxxx",
  "timestamp": 1679368912568
}
```

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