开放平台
取消
开放平台
中文
EN
取消
  • 第三方平台 API

    • # 获取小程序已备案详情

    调试诊断

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

    接口英文名：getOnlineIcpOrder

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

    # 1. 调用方式

    # HTTPS 调用

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

    # 云调用

    • 本接口不支持云调用

    # 第三方调用

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

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

    • 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

    # 2. 请求参数

    # 查询参数 Query String parameters

    参数名类型必填说明
    access_tokenstring是接口调用凭证，可使用 authorizer_access_token

    # 请求体 Request Payload

    无

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误信息
    icp_subjectobject备案主体信息，不包括图片、视频材料(参考：申请小程序备案接口的 `icp_subject`)
    icp_appletsobjarray微信小程序信息，不包括图片、视频材料(参考：申请小程序备案接口的 `icp_subject`)

    # Res.icp_subject Object Payload

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

    参数名类型说明
    base_infoobject主体基本信息
    personal_infoobject个人主体额外信息
    organize_infoobject主体额外信息（个人备案时，如果存在与主体负责人信息相同的字段，则填入相同的值）
    principal_infoobject主体负责人信息
    legal_person_infoobject法人信息（非个人备案，且主体负责人不是法人时，必填）

    # Res.icp_applets(Array) Object Payload

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

    参数名类型说明
    base_infoobject微信小程序基本信息
    principal_infoobject小程序负责人信息

    # Res.icp_subject.base_info Object Payload

    主体基本信息

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

    # Res.icp_subject.personal_info Object Payload

    个人主体额外信息

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

    # Res.icp_subject.organize_info Object Payload

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

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

    # Res.icp_subject.principal_info Object Payload

    主体负责人信息

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

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

    参数名类型说明
    namestring法人代表姓名，示例值：`"张三"`
    certificate_numberstring法人证件号码，示例值：`"110105199001011234"`

    # Res.icp_applets(Array).base_info Object Payload

    微信小程序基本信息

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

    # Res.icp_applets(Array).base_info.nrlx_detailsObject Payload

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

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

    # Res.icp_applets(Array).principal_info Object Payload

    小程序负责人信息

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

    # 4. 注意事项

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

    # 5. 代码示例

    # 5.1 个人类型

    请求示例

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

    # 5.2 企业类型

    请求示例

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

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

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

    # 7. 适用范围

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