# 获取小程序已备案详情

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

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

接口英文名：getOnlineIcpOrder

使用该接口获取小程序已备案详情。使用过程中如遇到问题，可在[小程序备案](https://developers.weixin.qq.com/community/minihome/mixflow/3398116438949937159)专区发帖交流

## 1. 调用方式

### HTTPS 调用

```bash
GET https://api.weixin.qq.com/wxa/icp/get_online_icp_order?access_token=ACCESS_TOKEN
```

### 云调用

- 本接口不支持云调用。

### 第三方调用

- 本接口支持第三方平台代商家调用。

- 该接口所属的权限集 id 为：18、156

- 服务商获得其中之一权限集授权后，可通过使用 [authorizer_access_token](/doc/oplatform/developers/dev/AuthorizerAccessToken.md) 代商家进行调用，具体可查看 [第三方调用](/doc/oplatform/Third-party_Platforms/2.0/Before_Develop/call_interface.md) 说明文档。

## 2. 请求参数

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

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

### 请求体 `Request Payload`

无

## 3. 返回参数

### 返回体 `Response Payload`

```json
[
  {
    "参数名": "errcode",
    "类型": "number",
    "说明": "错误码"
  },
  {
    "参数名": "errmsg",
    "类型": "string",
    "说明": "错误信息"
  },
  {
    "参数名": "icp_subject",
    "类型": "object",
    "说明": "备案主体信息，不包括图片、视频材料(参考：[申请小程序备案接口](api_applyicpfiling)的 \u0000INLINECODE_3\u0000)"
  },
  {
    "参数名": "icp_applets",
    "类型": "objarray",
    "说明": "微信小程序信息，不包括图片、视频材料(参考：[申请小程序备案接口](api_applyicpfiling)的 \u0000INLINECODE_4\u0000)"
  }
]
```

### Res.icp_subject `Object Payload`

备案主体信息，不包括图片、视频材料(参考：[申请小程序备案接口](api_applyicpfiling)的 `icp_subject`)

```json
[
  {
    "参数名": "base_info",
    "类型": "object",
    "说明": "主体基本信息"
  },
  {
    "参数名": "personal_info",
    "类型": "object",
    "说明": "个人主体额外信息"
  },
  {
    "参数名": "organize_info",
    "类型": "object",
    "说明": "主体额外信息（个人备案时，如果存在与主体负责人信息相同的字段，则填入相同的值）"
  },
  {
    "参数名": "principal_info",
    "类型": "object",
    "说明": "主体负责人信息"
  },
  {
    "参数名": "legal_person_info",
    "类型": "object",
    "说明": "法人信息（非个人备案，且主体负责人不是法人时，必填）"
  }
]
```

">

### Res.icp_applets(Array) `Object Payload`

微信小程序信息，不包括图片、视频材料(参考：[申请小程序备案接口](api_applyicpfiling)的 `icp_subject`)

```json
[
  {
    "参数名": "base_info",
    "类型": "object",
    "说明": "微信小程序基本信息"
  },
  {
    "参数名": "principal_info",
    "类型": "object",
    "说明": "小程序负责人信息"
  }
]
```

### Res.icp_subject.base_info `Object Payload`

主体基本信息

```json
[
  {
    "参数名": "type",
    "类型": "number",
    "说明": "主体性质，示例值：\u0000INLINECODE_10\u0000"
  },
  {
    "参数名": "name",
    "类型": "string",
    "说明": "主办单位名称，示例值：\u0000INLINECODE_11\u0000"
  },
  {
    "参数名": "province",
    "类型": "string",
    "说明": "备案省份，使用省份代码，示例值：\u0000INLINECODE_12\u0000(参考：[获取区域信息接口](api_queryicpdistrictcode))"
  },
  {
    "参数名": "city",
    "类型": "string",
    "说明": "备案城市，使用城市代码，示例值：\u0000INLINECODE_13\u0000(参考：[获取区域信息接口](api_queryicpdistrictcode))"
  },
  {
    "参数名": "district",
    "类型": "string",
    "说明": "备案县区，使用县区代码，示例值：\u0000INLINECODE_14\u0000(参考：[获取区域信息接口](api_queryicpdistrictcode))"
  },
  {
    "参数名": "address",
    "类型": "string",
    "说明": "通讯地址，必须属于备案省市区，地址开头的省市区不用填入，例如：通信地址为“北京市朝阳区高碑店路181号1栋12345室”时，只需要填写 \u0000INLINECODE_15\u0000 即可"
  },
  {
    "参数名": "comment",
    "类型": "string",
    "说明": "主体信息备注，根据需要，如实填写"
  },
  {
    "参数名": "record_number",
    "类型": "string",
    "说明": "主体备案号，示例值：粤B2-20090059（申请小程序备案时不用填写，查询已备案详情时会返回）"
  }
]
```

### Res.icp_subject.personal_info `Object Payload`

个人主体额外信息

```json
[
  {
    "参数名": "residence_permit",
    "类型": "string",
    "说明": "临时居住证明照片 media_id，个人备案且非本省人员，需要提供居住证、暂住证、社保证明、房产证等临时居住证明，示例值：\u0000INLINECODE_17\u0000"
  }
]
```

### Res.icp_subject.organize_info `Object Payload`

主体额外信息（个人备案时，如果存在与主体负责人信息相同的字段，则填入相同的值）

```json
[
  {
    "参数名": "certificate_type",
    "类型": "number",
    "说明": "主体证件类型，示例值：\u0000INLINECODE_19\u0000(参考：[获取证件类型接口](api_queryicpcertificatetypes))"
  },
  {
    "参数名": "certificate_number",
    "类型": "string",
    "说明": "主体证件号码，示例值：\u0000INLINECODE_20\u0000"
  },
  {
    "参数名": "certificate_address",
    "类型": "string",
    "说明": "主体证件住所，示例值：\u0000INLINECODE_21\u0000"
  },
  {
    "参数名": "certificate_photo",
    "类型": "string",
    "说明": "主体证件照片 media_id，如果小程序主体为非个人类型，则必填，示例值：\u0000INLINECODE_22\u0000"
  }
]
```

### Res.icp_subject.principal_info `Object Payload`

主体负责人信息

```json
[
  {
    "参数名": "name",
    "类型": "string",
    "说明": "负责人姓名，示例值：\u0000INLINECODE_24\u0000"
  },
  {
    "参数名": "mobile",
    "类型": "string",
    "说明": "负责人联系方式，示例值：\u0000INLINECODE_25\u0000"
  },
  {
    "参数名": "email",
    "类型": "string",
    "说明": "负责人电子邮件，示例值：\u0000INLINECODE_26\u0000"
  },
  {
    "参数名": "emergency_contact",
    "类型": "string",
    "说明": "负责人应急联系方式，示例值：\u0000INLINECODE_27\u0000"
  },
  {
    "参数名": "certificate_type",
    "类型": "number",
    "说明": "负责人证件类型，示例值：\u0000INLINECODE_28\u0000(参考：[获取证件类型接口](api_queryicpcertificatetypes)，此处只能填入单位性质属于个人的证件类型)"
  },
  {
    "参数名": "certificate_number",
    "类型": "string",
    "说明": "负责人证件号码，示例值：\u0000INLINECODE_29\u0000"
  },
  {
    "参数名": "certificate_validity_date_start",
    "类型": "string",
    "说明": "负责人证件有效期起始日期，格式为 YYYYmmdd，示例值：\u0000INLINECODE_30\u0000"
  },
  {
    "参数名": "certificate_validity_date_end",
    "类型": "string",
    "说明": "负责人证件有效期终止日期，格式为 YYYYmmdd，如证件长期有效，请填写 \u0000INLINECODE_31\u0000，示例值：\u0000INLINECODE_32\u0000"
  },
  {
    "参数名": "certificate_photo_front",
    "类型": "string",
    "说明": "负责人证件正面照片 media_id（身份证为人像面），示例值：\u0000INLINECODE_33\u0000"
  },
  {
    "参数名": "certificate_photo_back",
    "类型": "string",
    "说明": "负责人证件背面照片 media_id（身份证为国徽面），示例值：\u0000INLINECODE_34\u0000"
  },
  {
    "参数名": "authorization_letter",
    "类型": "string",
    "说明": "授权书 media_id，当主体负责人不是法人时需要主体负责人授权书，当小程序负责人不是法人时需要小程序负责人授权书，示例值：\u0000INLINECODE_35\u0000"
  },
  {
    "参数名": "verify_task_id",
    "类型": "string",
    "说明": "扫脸认证任务id(扫脸认证接口返回的task_id)，仅小程序负责人需要扫脸，主体负责人无需扫脸，示例值：\u0000INLINECODE_36\u0000"
  }
]
```

### Res.icp_subject.legal_person_info `Object Payload`

法人信息（非个人备案，且主体负责人不是法人时，必填）

```json
[
  {
    "参数名": "name",
    "类型": "string",
    "说明": "法人代表姓名，示例值：\u0000INLINECODE_38\u0000"
  },
  {
    "参数名": "certificate_number",
    "类型": "string",
    "说明": "法人证件号码，示例值：\u0000INLINECODE_39\u0000"
  }
]
```

__base_info">

### Res.icp_applets(Array).base_info `Object Payload`

微信小程序基本信息

```json
[
  {
    "参数名": "appid",
    "类型": "string",
    "说明": "小程序ID，不用填写，后台自动拉取"
  },
  {
    "参数名": "name",
    "类型": "string",
    "说明": "小程序名称，不用填写，后台自动拉取"
  },
  {
    "参数名": "service_content_types",
    "类型": "-",
    "说明": "小程序服务内容类型，只能填写二级服务内容类型，最多5个，示例值：\u0000INLINECODE_41\u0000(参考：[获取小程序服务类型接口](api_queryicpservicecontenttypes))"
  },
  {
    "参数名": "nrlx_details",
    "类型": "objarray",
    "说明": "前置审批项，列表中不能存在重复的前置审批类型id，如不涉及前置审批项，也需要填“以上都不涉及”"
  },
  {
    "参数名": "comment",
    "类型": "string",
    "说明": "请具体描述小程序实际经营内容、主要服务内容，该信息为主管部门审核重要依据，备注内容字数限制20-200字，请认真填写。（特殊备注要求请查看注意事项）"
  },
  {
    "参数名": "record_number",
    "类型": "string",
    "说明": "小程序备案号，示例值：粤B2-20090059-1626X（申请小程序备案时不用填写，查询已备案详情时会返回）"
  }
]
```

__base_info__nrlx_details">

### Res.icp_applets(Array).base_info.nrlx_details `Object Payload`

前置审批项，列表中不能存在重复的前置审批类型id，如不涉及前置审批项，也需要填“以上都不涉及”

```json
[
  {
    "参数名": "type",
    "类型": "number",
    "说明": "前置审批类型，示例值：\u0000INLINECODE_43\u0000(参考：[获取前置审批项接口](api_queryicpnrlxtypes))"
  },
  {
    "参数名": "code",
    "类型": "string",
    "说明": "前置审批号，如果前置审批类型不是“以上都不涉及”，则必填，示例值：\u0000INLINECODE_44\u0000"
  },
  {
    "参数名": "media",
    "类型": "string",
    "说明": "前置审批媒体材料 media_id，如果前置审批类型不是“以上都不涉及”，则必填，示例值：\u0000INLINECODE_45\u0000"
  }
]
```

__principal_info">

### Res.icp_applets(Array).principal_info `Object Payload`

小程序负责人信息

```json
[
  {
    "参数名": "name",
    "类型": "string",
    "说明": "负责人姓名，示例值：\u0000INLINECODE_47\u0000"
  },
  {
    "参数名": "mobile",
    "类型": "string",
    "说明": "负责人联系方式，示例值：\u0000INLINECODE_48\u0000"
  },
  {
    "参数名": "email",
    "类型": "string",
    "说明": "负责人电子邮件，示例值：\u0000INLINECODE_49\u0000"
  },
  {
    "参数名": "emergency_contact",
    "类型": "string",
    "说明": "负责人应急联系方式，示例值：\u0000INLINECODE_50\u0000"
  },
  {
    "参数名": "certificate_type",
    "类型": "number",
    "说明": "负责人证件类型，示例值：\u0000INLINECODE_51\u0000(参考：[获取证件类型接口](api_queryicpcertificatetypes)，此处只能填入单位性质属于个人的证件类型)"
  },
  {
    "参数名": "certificate_number",
    "类型": "string",
    "说明": "负责人证件号码，示例值：\u0000INLINECODE_52\u0000"
  },
  {
    "参数名": "certificate_validity_date_start",
    "类型": "string",
    "说明": "负责人证件有效期起始日期，格式为 YYYYmmdd，示例值：\u0000INLINECODE_53\u0000"
  },
  {
    "参数名": "certificate_validity_date_end",
    "类型": "string",
    "说明": "负责人证件有效期终止日期，格式为 YYYYmmdd，如证件长期有效，请填写 \u0000INLINECODE_54\u0000，示例值：\u0000INLINECODE_55\u0000"
  },
  {
    "参数名": "certificate_photo_front",
    "类型": "string",
    "说明": "负责人证件正面照片 media_id（身份证为人像面），示例值：\u0000INLINECODE_56\u0000"
  },
  {
    "参数名": "certificate_photo_back",
    "类型": "string",
    "说明": "负责人证件背面照片 media_id（身份证为国徽面），示例值：\u0000INLINECODE_57\u0000"
  },
  {
    "参数名": "authorization_letter",
    "类型": "string",
    "说明": "授权书 media_id，当主体负责人不是法人时需要主体负责人授权书，当小程序负责人不是法人时需要小程序负责人授权书，示例值：\u0000INLINECODE_58\u0000"
  },
  {
    "参数名": "verify_task_id",
    "类型": "string",
    "说明": "扫脸认证任务id(扫脸认证接口返回的task_id)，仅小程序负责人需要扫脸，主体负责人无需扫脸，示例值：\u0000INLINECODE_59\u0000"
  }
]
```

## 4. 注意事项

1. 该接口不会返回图片、视频材料。
2. 该接口返回的备案主体信息会经过脱敏处理。

## 5. 代码示例

### 5.1 个人类型

请求示例

```bach
curl https://api.weixin.qq.com/wxa/icp/get_online_icp_order?access_token=ACCESS_TOKEN
```

返回示例

```json
{
    "errcode": 0,
    "errmsg": "ok",
    "icp_subject": {
        "base_info": {
            "type": 5, // 个人类型
            "name": "*三",
            "province": "110000", // 北京市
            "city": "110100",
            "district": "110105", // 朝阳区
            "address": "高碑************5室",
            "comment": "主体备注"
        },
        "organize_info": {
            "certificate_type": 2,
            "certificate_number": "11**************34",
            "certificate_address": "北京******************5室"
        },
        "principal_info": {
            "name": "*三",
            "mobile": "13*******21",
            "email": "zh*********************om",
            "emergency_contact": "17*******34",
            "certificate_type": 2, // 身份证
            "certificate_number": "11**************34",
            "certificate_validity_date_start": "20230815",
            "certificate_validity_date_end": "20330815"
        }
    },
    "icp_applets": {
	"appid": "wx1111111122222222",
	"name": "张三测试号",
        "base_info": {
            "service_content_types": [
                3,
                4
            ], // 工具 & 家政
            "nrlx_details": [
                {
                    "type": 24 // 以上都不涉及
                }
            ],
            "comment": "小程序备注"
        },
        "principal_info": {
            "name": "张三",
            "mobile": "13012344321",
            "email": "zhangsan@zhangsancorp.com",
            "emergency_contact": "17743211234",
            "certificate_type": 2, // 身份证
            "certificate_number": "110105199001011234",
            "certificate_validity_date_start": "20230815",
            "certificate_validity_date_end": "20330815"
        }
    }
}
```

### 5.2 企业类型

请求示例

```bach
curl https://api.weixin.qq.com/wxa/icp/get_online_icp_order?access_token=ACCESS_TOKEN
```

返回示例

```json
{
    "errcode": 0,
    "errmsg": "ok",
    "icp_subject": {
        "base_info": {
            "type": 4, // 企业类型
            "name": "李四******公司",
            "province": "440000", // 广东省
            "city": "440100", // 广州市
            "district": "440105", // 海珠区
            "address": "新港********6栋",
            "comment": "主体备注"
        },
        "organize_info": {
            "certificate_type": 1, // 营业执照
            "certificate_number": "92**************3F",
            "certificate_address": "广东*****************6栋"
        },
        "principal_info": {
            "name": "*四",
            "mobile": "13*******21",
            "email": "li******************om",
            "emergency_contact": "17*******34",
            "certificate_type": 2, // 身份证
            "certificate_number": "44**************34",
            "certificate_validity_date_start": "20230815",
            "certificate_validity_date_end": "20330815"
        }
    },
    "icp_applets": {
        "base_info": {
            "appid": "wx1111222233334444",
            "name": "ABC123家政服务",
            "service_content_types": [
                3,
                4
            ], // 工具 & 家政
            "nrlx_details": [
                {
                    "type": 24 // 以上都不涉及
                }
            ],
            "comment": "小程序备注"
        },
        "principal_info": {
            "name": "王五",
            "mobile": "13011111111",
            "email": "wangwu@lisiwangwucorp.com",
            "emergency_contact": "15522223333",
            "certificate_type": 2, // 身份证
            "certificate_number": "440105199001019999",
            "certificate_validity_date_start": "20230815",
            "certificate_validity_date_end": "20330815"
        }
    }
}
```

## 6. 错误码

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

```json
[
  {
    "错误码": "0",
    "错误描述": "ok",
    "解决方案": "ok"
  },
  {
    "错误码": "86328",
    "错误描述": "无法找到资源",
    "解决方案": "无法找到资源"
  }
]
```

## 7. 适用范围

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