# 申请设置订单页path信息

[调试诊断](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_tools)

> 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。

接口英文名：applySetOrderPathInfo

该接口用于申请设置订单页path信息

## 1. 调用方式

### HTTPS 调用

```bash
POST https://api.weixin.qq.com/wxa/security/applysetorderpathinfo?access_token=ACCESS_TOKEN
```

### 云调用

- 本接口不支持云调用。

### 第三方调用

- 本接口仅支持第三方平台使用 [component_access_token](/doc/oplatform/developers/dev/ComponentAccessToken.md) 自己调用。

## 2. 请求参数

### 查询参数 `Query String Parameters`

```json
[
  {
    "参数名": "access_token",
    "类型": "string",
    "必填": "是",
    "说明": "接口调用凭证，可使用 [component_access_token](/doc/oplatform/openApi/ticket-token/api_getcomponentaccesstoken)"
  }
]
```

### 请求体 `Request Payload`

```json
[
  {
    "参数名": "batch_req",
    "类型": "object",
    "必填": "是",
    "说明": "批量申请的信息"
  }
]
```

### Body.batch_req `Object Payload`

批量申请的信息

```json
[
  {
    "参数名": "path",
    "类型": "string",
    "必填": "是",
    "说明": "申请提交的订单页path"
  },
  {
    "参数名": "img_list",
    "类型": "array",
    "必填": "否",
    "说明": "申请提交的图片url，审核版会显示"
  },
  {
    "参数名": "video",
    "类型": "string",
    "必填": "否",
    "说明": "申请提交的视频url，审核版会显示"
  },
  {
    "参数名": "test_account",
    "类型": "string",
    "必填": "否",
    "说明": "申请提交的测试账号，审核版会显示"
  },
  {
    "参数名": "test_pwd",
    "类型": "string",
    "必填": "否",
    "说明": "申请提交的测试密码，审核版会显示"
  },
  {
    "参数名": "test_remark",
    "类型": "string",
    "必填": "否",
    "说明": "申请提交的测试备注，审核版会显示"
  },
  {
    "参数名": "appid_list",
    "类型": "array",
    "必填": "是",
    "说明": "申请提交的批量的appid"
  }
]
```

## 3. 返回参数

### 返回体 `Response Payload`

```json
[
  {
    "参数名": "errcode",
    "类型": "number",
    "说明": "返回码"
  },
  {
    "参数名": "errmsg",
    "类型": "string",
    "说明": "返回码信息"
  }
]
```

## 4. 注意事项

appid_list：一次提交不超过100个appid。

# 其他说明 

## 批量提交结果通知
**推送内容解密后的示例：**
```xml
<xml>
<AppId><![CDATA[第三方平台appid]]></AppId>
<CreateTime>XXXXXX</CreateTime>
<InfoType><![CDATA[order_path_audit_result_notify]]></InfoType>
<List>申请结果列表
  <Appid>申请的appid</Appid>
  <AuditId>审核单id</AuditId>
  <RetCode>每个申请的返回码</RetCode>
</List>
</xml>
```

### 参数说明

| 属性 | 类型 | 说明 | 
| -- | -- | ---- | 
| list | Object Array | 申请结果列表 |  
| list[0].appid | string | 申请的appid |  
| list[0].audit_id | uint32 | 审核单id  |  
| list[0].ret_code | int32 | 每个申请的返回码，见附件 |  

## 附件

返回码说明

| 返回码 | 说明 | 
| -- | ---- | 
| 0 | 送审成功 |  
| -1 | 系统繁忙 |  
| -2 | appid非法 |  
| 1 | 重复提审 |  
| 30001 | 服务商无该appid的授权关系 |  
| 30002 | 申请材料上传格式有误 |  

申请状态说明

| 值 | 说明 | 
| -- | ---- | 
| 2 | 审核中 |
| 3 | 审核失败 |
| 4 | 审核通过 |

## 批量审核结果通知
**推送内容解密后的示例：**
```xml
<xml>
<AppId><![CDATA[第三方平台appid]]></AppId>
<CreateTime>XXXXXX</CreateTime>
<InfoType><![CDATA[order_path_audit_result_notify]]></InfoType>
<List>申请结果列表
  <Appid>申请的appid</Appid>
  <AuditId>审核单id</AuditId>
  <Status>订单页path状态</Status>
  <ApplyTime>申请时间</ApplyTime>
  <AuditTime>审核时间</AuditTime>
  <Reason>审核原因</Reason>
</List>
</xml>
```

### 参数说明

| 属性 | 类型 | 说明 | 
| -- | -- | ---- | 
| list | Object Array | 审核结果列表 |  
| list[0].appid | string | 申请的appid |  
| list[0].audit_id | uint32 | 审核单id  |  
| list[0].status | int32 | 订单页path状态，见附件 |  
| list[0].apply_time | uint32 | 申请时间 | 
| list[0].audit_time | uint32 | 审核时间 | 
| list[0].reason| string | 审核原因 | 

## 5. 代码示例

请求示例

```json
{
    "batch_req":{
    	"appid_list":[ // 一次提交不超过100个appid
    		"appid1","appid2"
    	]
    	"path":"pages/test_path",
    	"img_list":[
    		"img_url1","img_url2"
    	],
    	"video":"vedio_url",
    	"test_account":"test_user",
    	"test_pwd":"test_pwd",
    	"test_remark":"测试备注"
    }
}
```

返回示例

```json
{
    errcode:0,
    errmsg:"ok"
}
```

## 6. 错误码

以下是本接口的错误码列表，其他错误码可参考 [通用错误码](/doc/oplatform/developers/errCode/README.md)；调用接口遇到报错，可使用官方提供的 [API 诊断工具](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_errcode) 辅助定位和分析问题。

```json
[
  {
    "错误码": "-1",
    "错误描述": "system error",
    "解决方案": "系统繁忙，此时请开发者稍候再试"
  },
  {
    "错误码": "61042",
    "错误描述": "批量提交超过最大数量，一次提交的appid数量不超过100个",
    "解决方案": ""
  },
  {
    "错误码": "61043",
    "错误描述": "参数填写错误",
    "解决方案": ""
  },
  {
    "错误码": "61044",
    "错误描述": "path填写不规范",
    "解决方案": ""
  }
]
```

## 7. 适用范围

本接口支持「第三方平台」账号类型代调用，权限集请参考「调用方式」部分。其他账号类型如无特殊说明，均不可调用。