提交备案信息
收藏接口说明
该接口用于为小程序提交备案申请。
- 具体备案填写要求参考 小程序ICP备案指引。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/apps/v1/icp_record/submit_record_info/ |
| HTTP Method | POST |
| Scope | ma.icp_record.submit_record |
| 权限要求 |
|
请求参数
请求头
access-token必填String
示例：isvact.0801121846735352506a356a6
content-type必填String
示例：application/json
固定值"application/json"
Body展开全部子属性
app_info必填Struct
备 案应用信息
展开子属性
corp_info必填Struct
备案主体信息
展开子属性
请求示例
curl --location 'https://open.douyin.com/api/apps/v1/icp_record/submit_record_info' \ --header 'access-token: isvact.xxxx' \ --header 'Content-Type: application/json' \ --data-raw '{ "corp_info": { "corp_type": 4, "credentials_type": 1, "credentials_name": "1", "credentials_number": "xxxxx", "credentials_pic": { "path": "xxxx" }, "credentials_address": "xxxxx", "province_code": "320000", "province_name": "江苏省", "city_code": "120100", "city_name": "市辖区", "region_code": "120104", "region_name": "南开区", "communication_address": "xxxx", "incharge_people_name": "xxx", "incharge_people_credentials_type": 2, "incharge_people_credentials_number": "xxxxxxx", "incharge_people_credentials_front": { "path": "xxxxxx" }, "incharge_people_credentials_back": { "path": "xxxxx" }, "incharge_people_credentials_has_end_time": true, "incharge_people_credentials_valid_start_time": 1704038400, "incharge_people_credentials_valid_end_time": 1733328000, "incharge_people_email": "xxxxxx", "incharge_people_phone": "xxxxxx", "incharge_people_emergency_phone": "xxxxxx", "remark": "备注", "corp_other_materials": [ { "path": "xxxxxxx" } ], "corp_authority_letter":[ { "path": "xxxxxx" } ] }, "app_info": { "app_language": [1], "service_content_type_list": [1], "involve_pre_approval": true, "pre_approval_list": [ { "pre_approval_item_id": 3, "pre_approval_number": "5678", "pre_approval_files": [ { "path": "xxxxx" } ] } ], "incharge_people_email": "xxxxx", "incharge_people_phone": "xxxx", "incharge_people_emergency_phone": "xxxx", "remark": "备注", "facial_recognition_token": "xxxxx", "app_other_materials": [ { "path": "xxxxxx" } ] } }'
响应参数
Body
err_msg必填String
错误描述
err_no必填Int32
错误码
log_id必填String
标识请求的唯一id
响应示例
正常响应示例异常响应示例
{ "err_msg": "", "err_no": 0, "log_id": "20231212184350A802F6FF1672E3072B93" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 6002 | 主体负责人信息不正确 | |
| 200 | 6003 | 存在进行中的备案请求，不可重复备案 | |
| 200 | 6004 | 主体类型不正确 | |
| 200 | 6005 | 证件类型不正确 | |
| 200 | 6006 | 服务内容不正确 | |
| 200 | 6007 | 前置审批类型不正确 | |
| 200 | 6011 | 应用名称不合法，请先修改名称 | |
| 200 | 6012 | 小程序备案主体与入驻主体不一致,请保持一致 | |
| 200 | 6013 | 姓名与身份证号不匹配,请修改后重新提交 | |
| 200 | 6014 | 您已完成备案, 请勿重复备案 | |
| 200 | 6015 | 服务内容个数超出限制 | |
| 200 | 6016 | 证件不在有效期内 | |
| 200 | 6017 | 证件有效期小于3个月, 请更新证件 | |
| 200 | 6019 | 人证核验token不存在或已过期 | |
| 200 | 6026 | 小程序未迁移到抖音开发者平台 | |
| 200 | 6027 | 地域编码信息不正确 |
备案审核结果通知
备案审核结果出来之后，会自动触发消息发送，然后开放平台服务器会向第三方小程序应用的【消息与事件接收 URL】以 HTTP POST 方式推送相应授权小程序的备案审核结果。
POST 数据示例：
{ "Nonce": "4464221", "TimeStamp": "1535551395", "Encrypt": "Encrypt Message xxxxxxxx", "MsgSignature": "ba394c04acece6c2c0edee058c5dddf82474b8ee" }
{ "AppId": "xxxx", "TpAppId": "xxxx", "Event": "ICP_RECORD_STATUS", "EventTime": "2023-12-12 17:09:28", "EventContent": { "app_name": "x", "reasons": ["xxxx"], "status": 2 } }
消息体字段含义如下：
名称 | 数据类型 | 描述 | ||
AppId | string | 授权小程序 appid | ||
TpAppId | string | 第三方小程序 appid | ||
EventTime | string | 推送事件时间 | ||
Event | string | 推送事件类型，固定"ICP_RECORD_STATUS" | ||
EventContent | object | 备案审核审核结果 | ||
| app_name | string | 小程序名称 | |
| status | number | 备案状态 | |
| reasons | array<string> | 备案失败原因列表 | |
