# 获取小程序已备案详情

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

# 接口说明

# 接口英文名

getOnlineIcpOrder

# 功能描述

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

# 注意事项

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

# 调用方式

# 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 无法找到资源 无法找到资源