# 获取小程序已备案详情

接口应在服务器端调用，详细说明参见服务端API。

# 接口说明

# 接口英文名

getOnlineIcpOrder

# 功能描述

使用该接口获取小程序已备案详情。使用过程中如遇到问题，可在开放平台服务商专区发帖交流

# 注意事项

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

# 调用方式

# HTTPS 调用


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

# 第三方调用

调用方式以及出入参和HTTPS相同，仅是调用的token不同
该接口所属的权限集id为：18、156
服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

# 请求参数

属性	类型	必填	说明
access_token	string	是	接口调用凭证，该参数为 URL 参数，非 Body 参数。使用authorizer_access_token

# 返回参数

属性类型说明

errcode number 错误码

errmsg string 错误信息

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

属性类型说明

base_info object 主体基本信息

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

personal_info object 个人主体额外信息

	属性	类型	说明
	residence_permit	string	临时居住证明照片 media_id，个人备案且非本省人员，需要提供居住证、暂住证、社保证明、房产证等临时居住证明，示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`

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

属性	类型	说明
certificate_type	number	主体证件类型，示例值：`2`(参考：获取证件类型接口)
certificate_number	string	主体证件号码，示例值：`"110105199001011234"`
certificate_address	string	主体证件住所，示例值：`"北京市朝阳区高碑店路181号1栋12345室"`
certificate_photo	string	主体证件照片 media_id，如果小程序主体为非个人类型，则必填，示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`

principal_info object 主体负责人信息

属性	类型	说明
name	string	负责人姓名，示例值：`"张三"`
mobile	string	负责人联系方式，示例值：`"13012344321"`
email	string	负责人电子邮件，示例值：`"zhangsan@zhangsancorp.com"`
emergency_contact	string	负责人应急联系方式，示例值：`"17743211234"`
certificate_type	number	负责人证件类型，示例值：`2`(参考：获取证件类型接口，此处只能填入单位性质属于个人的证件类型)
certificate_number	string	负责人证件号码，示例值：`"110105199001011234"`
certificate_validity_date_start	string	负责人证件有效期起始日期，格式为 YYYYmmdd，示例值：`"20230815"`
certificate_validity_date_end	string	负责人证件有效期终止日期，格式为 YYYYmmdd，如证件长期有效，请填写 `"长期"`，示例值：`"20330815"`
certificate_photo_front	string	负责人证件正面照片 media_id（身份证为人像面），示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`
certificate_photo_back	string	负责人证件背面照片 media_id（身份证为国徽面），示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`
authorization_letter	string	授权书 media_id，当主体负责人不是法人时需要主体负责人授权书，当小程序负责人不是法人时需要小程序负责人授权书，示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`
verify_task_id	string	扫脸认证任务id(扫脸认证接口返回的task_id)，仅小程序负责人需要扫脸，主体负责人无需扫脸，示例值：`"R5PqRPNb6GmG3i0rqd4pTg"`

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

	属性	类型	说明
	name	string	法人代表姓名，示例值：`"张三"`
	certificate_number	string	法人证件号码，示例值：`"110105199001011234"`

icp_applets array<object> 微信小程序信息，不包括图片、视频材料(参考：申请小程序备案接口的 ICPApplets)

属性类型说明

base_info object 微信小程序基本信息

属性类型说明

appid string 小程序ID，不用填写，后台自动拉取

name string 小程序名称，不用填写，后台自动拉取

service_content_types array<number> 小程序服务内容类型，只能填写二级服务内容类型，最多5个，示例值：[3, 4](参考：获取小程序服务类型接口)

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

属性	类型	说明
type	number	前置审批类型，示例值：`2`(参考：获取前置审批项接口)
code	string	前置审批号，如果前置审批类型不是“以上都不涉及”，则必填，示例值：`"粤-12345号"`
media	string	前置审批媒体材料 media_id，如果前置审批类型不是“以上都不涉及”，则必填，示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`

comment string 请具体描述小程序实际经营内容、主要服务内容，该信息为主管部门审核重要依据，备注内容字数限制20-200字，请认真填写。（特殊备注要求请查看注意事项）

record_number string 小程序备案号，示例值：粤B2-20090059-1626X（申请小程序备案时不用填写，查询已备案详情时会返回）

principal_info object 小程序负责人信息

属性	类型	说明
name	string	负责人姓名，示例值：`"张三"`
mobile	string	负责人联系方式，示例值：`"13012344321"`
email	string	负责人电子邮件，示例值：`"zhangsan@zhangsancorp.com"`
emergency_contact	string	负责人应急联系方式，示例值：`"17743211234"`
certificate_type	number	负责人证件类型，示例值：`2`(参考：获取证件类型接口，此处只能填入单位性质属于个人的证件类型)
certificate_number	string	负责人证件号码，示例值：`"110105199001011234"`
certificate_validity_date_start	string	负责人证件有效期起始日期，格式为 YYYYmmdd，示例值：`"20230815"`
certificate_validity_date_end	string	负责人证件有效期终止日期，格式为 YYYYmmdd，如证件长期有效，请填写 `"长期"`，示例值：`"20330815"`
certificate_photo_front	string	负责人证件正面照片 media_id（身份证为人像面），示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`
certificate_photo_back	string	负责人证件背面照片 media_id（身份证为国徽面），示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`
authorization_letter	string	授权书 media_id，当主体负责人不是法人时需要主体负责人授权书，当小程序负责人不是法人时需要小程序负责人授权书，示例值：`"4ahCGpd3CYkE6RpkNkUR5czt3LvG8xDnDdKAz6bBKttSfM8p4k5Rj6823HXugPwQBurgMezyib7"`
verify_task_id	string	扫脸认证任务id(扫脸认证接口返回的task_id)，仅小程序负责人需要扫脸，主体负责人无需扫脸，示例值：`"R5PqRPNb6GmG3i0rqd4pTg"`

# 调用示例

示例说明: 个人类型

# 请求数据示例


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

# 返回数据示例


{
    "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"
        }
    }
}

示例说明: 企业类型

# 请求数据示例


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

# 返回数据示例


{
    "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"
        }
    }
}

# 错误码

错误码	错误描述	解决方案
0	ok	ok
86328	无法找到资源	无法找到资源