数码使用-绑定

#  数码使用 `公开`

## 支持场景
>  已支持：1：零散绑定 2：码段绑定 3：卷内绑定 4：整卷绑定

## API描述
>  API描述：1零散绑定：通过数码批量进行绑定；2码段绑定，通过顺序码码段进行绑定；3卷内绑定，限定卷标号，绑定卷标号中的数码；4：整卷绑定，开始卷标号与结束卷标号绑定

## 请求流程

>   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                                                   |
| 请求路径 | /ip/app/open/v1/code/binding/add                |
| 请求头   | Content-Type: application/json                         |

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

## 请求参数

| 参数名称  | 是否必须 | 示例 | 备注      |
|-----------|----------|------|-----------|
| bindingType | 是   | 1   | 1：零散绑定 2：码段绑定 3：卷内绑定 4：整卷绑定       |
| codes | 否| ["","",""]  | 零散绑定数码， bindingType = 1 时必传|
| codeSegments | 否|   | 码段绑定，bindingType = 2/3/4时必传 |
-- startCode | 是| ""  |码段开始数码  |
-- endCode | 是| ""  |码段结束数码  |
| codeUseCount | 否|   | 本次使用数量 |
| printCode | 否| ""  | 卷标号，bindingType = 3时必传 |
| productId | 否| ""  | 数码绑定商品 |
| remark | 否| ""  | 备注 |
| f1 | 否| ""  | 扩展字段 |
| f2 | 否| ""  | 扩展字段 |
| f3 | 否| ""  | 扩展字段 |
| f4 | 否| ""  | 扩展字段 |
| f5 | 否| ""  | 扩展字段 |
| f6 | 否| ""  | 扩展字段 |
| f7 | 否| ""  | 扩展字段 |
| f8 | 否| ""  | 扩展字段 |
| f9 | 否| ""  | 扩展字段 |
| f10 | 否| ""  | 扩展字段 |

## 返回消息体

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

## 出参

## 请求示例
``` text
POST /ip/app/open/v1/code/binding/add
#参数示例:零散数码绑定
{
  "bindingType": "1",
  "codes": [
    "234401000337"
  ],
  "productId": "1095bdee3f3a420cb4847d1cd55c15d4",
  "remark": "11111"
}
#参数示例:顺序码码段绑定
{
  "bindingType": "2",
  "codeSegments": [
    {
      "startCode": "234401000338",
      "endCode": "234401000340",
      "codeUseCount": "3"
    }
  ],
  "productId": "e3eb0f4a2dfe4cf2a57b75341a32a01b",
  "remark": "22222"
}
```

## 响应示例

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

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

## 返回码
| 返回码 | 描述 |  解决方案|
| --- | --- | --- | 
| 200 | 成功 |  | 
| 400 | 参数错误 | 
| 21040002 | 扩展字段校验异常
| 21040066 | 扩展字段配置正则不通过
| 21815001 | 绑定参数不能为空
| 21815002 | 绑定类型不能为空
| 21815003 | 数码不能为空
| 21815013 | 存在重复的数码
| 21815005 | 存在不是本企业数码
| 21815025 | 调用解码接口失败
| 21815009 | 码段数据不正确
| 21815007 | 开始数码与结束数码前四位不一致
| 21815010 | 可拆分的原始码段不存在
| 21815011 | 开始数码与结束数码存在跨码段
| 21815027 | 印厂码码段拆分绑定请使用卷内绑定或整卷绑定
| 21815012 | 码段数据异常