资质管理
更新时间:2026-07-31 14:59:35
更新时间:2026/6/17日 更新内容:更新“资质添加、资质查询”相关接口。
接入准备
- 1、请先联系商务开通"深度接口账号"才能使用本目录下所有接口。
- 2、请登录控制台拿到发送短信的"API账号",增加资质根据API账号为导向的。
- 3、应用场景材料:准备经办人授权书。
- 4、实名信息:经办人身份证文字版、营业执照。
1、新增资质
1.1 请求地址
- 请求方式:post
- Content-Type:application/x-www-form-urlencoded
- 请求地址:
https://api.chuanglan.com/api/apis/v1/qualification/add
1.2 请求参数
| 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|
| username | String | 是 |
深度接口账号名
| "username":"13899999999" |
| timestamp | String | 是 |
时间戳
| "timestamp":"1755068823" |
| signature | String | 是 |
验签
| "signature":"e10adc3949ba59abbe56e057f20f883e" |
| api_name | String | 是 |
发短信的API账号
| "api_name":"N617810_N7533106" |
| end_type | String | 否 |
签名使用方终端类型
| "end_type":"2" |
| share_type | String | 是 |
是否指定使用方
| "share_type":"1" |
| enterprise_name | String | 是 |
企业名称
| "enterprise_name":"上海创蓝云智信息科技股份有限公司" |
| unified_social_credit_code | String | 是 |
统一社会信用代码
| "unified_social_credit_code":"91310115579195569K" |
| legal_name | String | 是 |
法人姓名
| "legal_name":"李四" |
| attention_line | String | 是 |
经办人姓名
| "attention_line":"张三" |
| attention_id_card | String | 是 |
经办人身份证号
| "attention_id_card":"310101199001011234" |
| phone_num | String | 是 |
经办人手机号
| "phone_num":"13899999999" |
| identity_type | String | 否 |
经办人类型
| "identity_type":"2" |
| business_license_img | String | 是 |
签名实名营业执照
| "business_license_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| legal_national_emblem_identity_img | String | 是 |
法人身份证国徽面
| "legal_national_emblem_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| legal_figure_identity_img | String | 是 |
法人身份证人像面
| "legal_figure_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| agent_authorization_letter_img | String | 否 |
经办人授权书
| "agent_authorization_letter_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| figure_identity_img | String | 否 |
经办人身份证人像面
| "figure_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| national_emblem_identity_img | String | 否 |
经办人身份证国徽面
| "national_emblem_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| identity_office_photo_img | String | 否 |
经办人办公场景照片
| "identity_office_photo_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| contract_head_img | String | 否 |
合同首页
| "contract_head_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| contract_validity_img | String | 否 |
业务/合同有效期页
| "contract_validity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| contract_tail_img | String | 否 |
合同尾页
| "contract_tail_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
1.3 请求示例(换行易读,实际请求需删除换行)
username=17321332052×tamp=1659583889&signature=f3ecceccfb68922930e3f139b599477e&api_name=N123456&enterprise_name=北京XX科技有限公司&unified_social_credit_code=91110000XXXXXXXXXX&attention_line=张三&attention_id_card=110101199001011234&phone_num=13800138000&end_type=2&identity_type=2
1.4 响应参数
| 参数名 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| code | String | 000000 代表成功,其他代表失败,会有 message 错误信息返回 | |
| status | String | 状态说明 success:成功,error:失败 | |
| msg | String | 提示信息(Unicode字符编码,需自行解码为中文) | |
| data | object | 返回数据 | |
| -id | Long | 资质id |
返回数据示例(JSON):
{
"code": "000000",
"data": {
"id": 341708
},
"msg": "深度接口新增终端资质成功",
"status": "success"
}2、资质查询
2.1 请求地址
- 请求方式:post
- Content-Type:application/x-www-form-urlencoded
- 请求地址:
https://api.chuanglan.com/api/apis/v1/qualification/list
2.2 请求参数
| 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|
| username | String | 是 |
深度接口账号名
| "username":"13899999999" |
| timestamp | String | 是 |
时间戳
| "timestamp":"1755068823" |
| signature | String | 是 |
验签
| "signature":"e10adc3949ba59abbe56e057f20f883e" |
| api_name | String | 是 |
发短信的API账号
| "api_name":"N617810_N7533106" |
| end_customer_id | Long | 否 |
终端资质 ID
| |
| company_name | String | 否 |
公司名称
| |
| end_type | String | 否 |
签名使用方终端类型
| |
| start | Integer | 是 |
页码
| |
| length | Integer | 是 |
每页条数
|
2.3 请求示例
username=17321332052×tamp=1659583889&signature=f3ecceccfb68922930e3f139b599477e&api_name=N123456
2.4 响应参数
| 参数名 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| code | String | 000000 代表成功,其他代表失败,会有 message 错误信息返回 | |
| status | String | 状态说明 success:成功,error:失败 | |
| msg | String | 提示信息(Unicode字符编码,需自行解码为中文) | |
| data | object | 返回数据 | |
| -total | Integer | 返回分页总数量 | |
| -list | object [] | item 类型: object | |
| --end_customer_id | Long | 终端客户 ID | |
| --enterprise_name | String | 企业名称 | |
| --unified_social_credit_code | String | 统一社会信用代码 | |
| --attention_line | String | 经办人姓名 | |
| --attention_id_card | String | 经办人身份证号 | |
| --legal_name | String | 法人姓名 | |
| --phone_num | String | 经办人手机号 | |
| --identity_type | String | 经办人类型:1=法人;2=经办人 | |
| --end_type | String | 终端类型:1=自用(直客);2=他用(终端客户) | |
| --one_to_many_flag | String | 是否一人多企:0=否;1=是 | |
| --agent_authorization_letter_url | String | 经办人授权书 URL | |
| --business_license_url | String | 签名实名营业执照 URL | |
| --national_emblem_identity_url | String | 经办人身份证国徽面 URL | |
| --figure_identity_url | String | 经办人身份证人像面 URL | |
| --legal_national_emblem_identity_url | String | 法人身份证国徽面 URL | |
| --legal_figure_identity_url | String | 法人身份证人像面 URL | |
| --identity_office_photo_url | String | 经办人办公场景照片 URL | |
| --contract_head_page_url | String | 合同首页 URL | |
| --contract_validity_page_url | String | 合同有效期页 URL | |
| --contract_tail_page_url | String | 合同尾页 URL | |
| --remark | String | 备注 |
返回数据示例(JSON):
{
"code": "000000",
"msg": "深度接口终端资质分页查询成功",
"data": {
"total": 1,
"list": [
{
"end_customer_id": 10086,
"enterprise_name": "北京XX科技有限公司",
"unified_social_credit_code": "91110000XXXXXXXXXX",
"attention_line": "张三",
"attention_id_card": "110101199001011234",
"legal_name": "李四",
"phone_num": "13800138000",
"identity_type": "2",
"end_type": "2",
"one_to_many_flag": "0",
"agent_authorization_letter_url": "https://xxx.xxx.com/xxx.jpg",
"business_license_url": "https://xxx.xxx.com/xxx.jpg",
"national_emblem_identity_url": "https://xxx.xxx.com/xxx.jpg",
"figure_identity_url": "https://xxx.xxx.com/xxx.jpg",
"legal_national_emblem_identity_url": "https://xxx.xxx.com/xxx.jpg",
"legal_figure_identity_url": "https://xxx.xxx.com/xxx.jpg",
"identity_office_photo_url": "https://xxx.xxx.com/xxx.jpg",
"contract_head_page_url": "https://xxx.xxx.com/xxx.jpg",
"contract_validity_page_url": "https://xxx.xxx.com/xxx.jpg",
"contract_tail_page_url": "https://xxx.xxx.com/xxx.jpg",
"remark": ""
}
]
}
}3、编辑资质
3.1 请求地址
- 请求方式:post
- Content-Type:application/x-www-form-urlencoded
- 请求地址:
https://api.chuanglan.com/api/apis/v1/qualification/modify
3.2 请求参数
| 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|
| username | String | 是 |
深度接口账号名
| "username":"13899999999" |
| timestamp | String | 是 |
时间戳
| "timestamp":"1755068823" |
| signature | String | 是 |
验签
| "signature":"e10adc3949ba59abbe56e057f20f883e" |
| api_name | String | 是 |
发短信的API账号
| "api_name":"N617810_N7533106" |
| end_customer_id | Long | 是 |
终端资质 ID
| |
| legal_name | String | 否 |
法人姓名
| |
| phone_num | String | 否 |
经办人手机号
| |
| business_license_img | String | 否 |
签名实名营业执照
| "business_license_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| legal_national_emblem_identity_img | String | 否 |
法人身份证国徽面
| "legal_national_emblem_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| legal_figure_identity_img | String | 否 |
法人身份证人像面
| "legal_figure_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| agent_authorization_letter_img | String | 否 |
经办人授权书
| "agent_authorization_letter_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| figure_identity_img | String | 否 |
经办人身份证人像面
| "figure_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| national_emblem_identity_img | String | 否 |
经办人身份证国徽面
| "national_emblem_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| identity_office_photo_img | String | 否 |
经办人办公场景照片
| "identity_office_photo_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| contract_head_img | String | 否 |
合同首页
| "contract_head_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| contract_validity_img | String | 否 |
业务/合同有效期页
| "contract_validity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| contract_tail_img | String | 否 |
合同尾页
| "contract_tail_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| remark | String | 否 |
备注
|
3.3 请求示例
username=17321332052×tamp=1659583889&signature=f3ecceccfb68922930e3f139b599477e&api_name=N123456
3.4 响应参数
| 参数名 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| code | String | 000000 代表成功,其他代表失败,会有 message 错误信息返回 | |
| status | String | 状态说明 success:成功,error:失败 | |
| msg | String | 提示信息(Unicode字符编码,需自行解码为中文) |
返回数据示例(JSON):
{
"code": "000000",
"msg": "深度接口编辑终端资质成功",
"status": "success"
}4、删除资质
4.1 请求地址
- 请求方式:post
- Content-Type:application/x-www-form-urlencoded
- 请求地址:
https://api.chuanglan.com/api/apis/v1/qualification/del
4.2 请求参数
| 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|---|---|---|---|
| username | String | 是 |
深度接口账号名
| "username":"13899999999" |
| timestamp | String | 是 |
时间戳
| "timestamp":"1755068823" |
| signature | String | 是 |
验签
| "signature":"e10adc3949ba59abbe56e057f20f883e" |
| api_name | String | 是 |
发短信的API账号
| "api_name":"N617810_N7533106" |
| end_customer_id | Long | 是 |
终端资质 ID
| "end_customer_id":111111 |
4.3 请求示例
username=17321332052×tamp=1659583889&signature=f3ecceccfb68922930e3f139b599477e&api_name=N123456
4.4 响应参数
| 参数名 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| code | String | 000000 代表成功,其他代表失败,会有 message 错误信息返回 | |
| status | String | 状态说明 success:成功,error:失败 | |
| msg | String | 提示信息(Unicode字符编码,需自行解码为中文) |
返回数据示例(JSON):
{
"code": "000000",
"msg": "深度接口删除终端资质成功",
"status": "success"
}这篇文档对您有帮助吗?




