墨尔本项目-数码组合接口

#  墨尔本项目-数码组合接口 `公开`

## 支持场景
>  已支持：墨尔本项目-数码组合接口

## API描述
>  API描述：墨尔本项目-数码组合接口

## 请求信息

| 协议     | HTTPS                                                  |
|----------|-----------------------------------------------------------------------------------------------|
| 请求方法 | GET                                                   |
| 请求路径 | /digit/v1/digit/melbourne/combine-code                |

## 请求参数

<tr>
  	<td>gtin</td>
  	<td>string</td>
  	<td>是</td>
  	<td>GTIN</td>
  </tr>

<tr>
  	<td>prd</td>
  	<td>string</td>
  	<td>是</td>
  	<td>PRD 生产日期/对应LOT</td>
  </tr>

<tr>
  	<td>useBy</td>
  	<td>string</td>
  	<td>是</td>
  	<td>USE BY 到期日期</td>
  </tr>

<tr>
  	<td>lot</td>
  	<td>string</td>
  	<td>是</td>
  	<td>生产批次号/对应QTY</td>
  </tr>

<tr>
  	<td>serial</td>
  	<td>string</td>
  	<td>是</td>
  	<td>箱码/托码（对应SSCC）</td>
  </tr>

</table>

## 返回消息体

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

## 请求示例
``` text
请求地址：{URL}/digit/v1/digit/melbourne/combine-code?gtin=gtin&prd=prd&useBy=useBy&lot=lot&serial=serial
```

## 响应示例

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

## 异常示例
```json
{
  "code": 21102001,
  "message": "param：[gtin],verify fail：[GTIN为空],error code: [21102001]",
  "data": null,
  "timestamp": 1683874486051,
  "traceId":"xxxxxx"
}
```

## 返回码
| 返回码 | 描述 |  解决方案|
| --- | --- | --- |
200|成功|
21102001|GTIN为空|
21102002|PRD为空|
21102003|USE BY为空|
21102004|LOT为空|
21102005|SERIAL为空|