码包密钥查询

# 码包密码查询接口 `公开`

## 支持场景

> 第三方按企业号和订单编号获取圣戈班码包解压密码。

## API描述

> 成功时返回 JSON，密码字符串位于 data 字段。调用方按字符串读取。

## 请求流程

> 1. 在超8平台申请第三方应用的 Access Key 和密钥。
> 2. 申请 Access Token。操作步骤见 [获取 AccessToken](https://developers.yesno.com.cn/doc/57/)。
> 3. 携带 Access Token 调用开放接口。调用流程见 [接入指南](https://developers.yesno.com.cn/doc/56/)。

## 请求信息

采用 GET 按企业号和订单编号读取已有的码包密码。

| 协议 | HTTPS |
|---|---|
| 请求方法 | GET |
| 请求路径 | /digit/order/v1/open/code-pack-send/password-saint-gobain |

## header头

请求头字段见 [通用请求头](https://developers.yesno.com.cn/doc/56/)。

## 传入参数

| 参数名称 | 是否必填 | 参数类型 | 参数说明 |
|---|---|---|---|
| enterpriseNo | 是 | String | 订单所属企业号，通过 URL 查询参数传入 |
| orderNo | 是 | String | 订单编号，通过 URL 查询参数传入 |

## 返回消息体

<table>
  <tr><td>名称</td><td>类型</td><td>是否必须</td><td>默认值</td><td>备注</td><td>其他信息</td></tr>
  <tr><td>message</td><td>string</td><td>非必须</td><td></td><td>响应说明</td><td></td></tr>
  <tr><td>timestamp</td><td>integer</td><td>非必须</td><td></td><td>Unix 时间戳，单位为毫秒</td><td>format: int64</td></tr>
  <tr><td>traceId</td><td>string</td><td>非必须</td><td></td><td>请求追踪 ID，按实际返回</td><td></td></tr>
  <tr><td>code</td><td>integer</td><td>必须</td><td></td><td>业务返回码，200 表示成功</td><td>format: int32</td></tr>
  <tr><td>data</td><td>string</td><td>必须</td><td></td><td>码包解压密码，保留前导零和特殊字符</td><td></td></tr>
</table>

### 成功响应头

<table>
  <tr><td>名称</td><td>类型</td><td>是否必须</td><td>默认值</td><td>备注</td><td>其他信息</td></tr>
  <tr><td>Content-Type</td><td>string</td><td>必须</td><td></td><td>JSON 响应媒体类型</td><td>application/json</td></tr>
  <tr><td>Cache-Control</td><td>string</td><td>必须</td><td></td><td>禁止缓存密码</td><td>no-store</td></tr>
</table>

## 请求示例

```http
GET {URL}/digit/order/v1/open/code-pack-send/password-saint-gobain?enterpriseNo=100001&orderNo=EXT_20261106_00001
Accept: application/json
```

## 出参示例

```http
HTTP/1.1 200 OK
Content-Type: application/json
Cache-Control: no-store

{
  "code": 200,
  "message": "success",
  "data": "008642",
  "timestamp": 1793923200000,
  "traceId": "example-trace-password"
}
```

## 返回码

调用方在响应体 code 为 200 时读取 data。

| 返回码 | 描述 | 解决方案 |
|---|---|---|
| 200 | 查询成功 | 从 JSON 的 data 字段读取密码字符串 |
| 21100001 | 参数错误 | HTTP 400。检查 orderNo 是否为空或查询参数格式是否有误 |
| 21100066 | 企业号不能为空 | HTTP 400。传入订单所属企业号 enterpriseNo |
| 21102006 | 订单不存在或不在可访问范围内 | HTTP 404。核对订单所属企业号、订单编号及凭证权限 |
| 409 | 码包密码尚未就绪 | HTTP 409。待密码生成后重试 |
| 21100026 | 系统异常，查询密码失败 | HTTP 500。稍后重试，持续失败时提供 traceId 排查 |