更新时间: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 | 是 |
验签
- 标准的 MD5 加密(32 位小写值)
- 加密规则:signature=md5(username+password+timestamp),无需+号,直接按照顺序拼接3个值进行MD5。双方进行校验。
| "signature":"e10adc3949ba59abbe56e057f20f883e" |
| api_name | String | 是 |
发短信的API账号
- 请填写对应的API账号
- 注:原sub_id和appid升级版参数,现在直接传对应的API账号值即可
| "api_name":"N617810_N7533106" |
| end_type | String | 否 |
签名使用方终端类型
- 1=自用(直客);2=他用(终端客户),默认值=2
| "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 | 是 |
签名实名营业执照
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "business_license_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| legal_national_emblem_identity_img | String | 是 |
法人身份证国徽面
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "legal_national_emblem_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| legal_figure_identity_img | String | 是 |
法人身份证人像面
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "legal_figure_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| agent_authorization_letter_img | String | 否 |
经办人授权书
- 经办人类型为经办人时需上传
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "agent_authorization_letter_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| figure_identity_img | String | 否 |
经办人身份证人像面
- 经办人类型为经办人时需上传
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "figure_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| national_emblem_identity_img | String | 否 |
经办人身份证国徽面
- 经办人类型为经办人时需上传
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "national_emblem_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| identity_office_photo_img | String | 否 |
经办人办公场景照片
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "identity_office_photo_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| contract_head_img | String | 否 |
合同首页
- 签名实名使用方为他人时需上传
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "contract_head_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| contract_validity_img | String | 否 |
业务/合同有效期页
- 签名实名使用方为他人时需上传
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "contract_validity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| contract_tail_img | String | 否 |
合同尾页
- 签名实名使用方为他人时需上传
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "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 | 是 |
验签
- 标准的 MD5 加密(32 位小写值)
- 加密规则:signature=md5(username+password+timestamp),无需+号,直接按照顺序拼接3个值进行MD5。双方进行校验。
| "signature":"e10adc3949ba59abbe56e057f20f883e" |
| api_name | String | 是 |
发短信的API账号
- 请填写对应的API账号
- 注:原sub_id和appid升级版参数,现在直接传对应的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 | 是 |
验签
- 标准的 MD5 加密(32 位小写值)
- 加密规则:signature=md5(username+password+timestamp),无需+号,直接按照顺序拼接3个值进行MD5。双方进行校验。
| "signature":"e10adc3949ba59abbe56e057f20f883e" |
| api_name | String | 是 |
发短信的API账号
- 请填写对应的API账号
- 注:原sub_id和appid升级版参数,现在直接传对应的API账号值即可
| "api_name":"N617810_N7533106" |
| end_customer_id | Long | 是 |
终端资质 ID
| |
| legal_name | String | 否 |
法人姓名
| |
| phone_num | String | 否 |
经办人手机号
| |
| business_license_img | String | 否 |
签名实名营业执照
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "business_license_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| legal_national_emblem_identity_img | String | 否 |
法人身份证国徽面
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "legal_national_emblem_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| legal_figure_identity_img | String | 否 |
法人身份证人像面
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "legal_figure_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| agent_authorization_letter_img | String | 否 |
经办人授权书
- 经办人类型为经办人时需上传
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "agent_authorization_letter_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| figure_identity_img | String | 否 |
经办人身份证人像面
- 经办人类型为经办人时需上传
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "figure_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| national_emblem_identity_img | String | 否 |
经办人身份证国徽面
- 经办人类型为经办人时需上传
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "national_emblem_identity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| identity_office_photo_img | String | 否 |
经办人办公场景照片
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "identity_office_photo_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| contract_head_img | String | 否 |
合同首页
- 签名实名使用方为他人时需上传
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "contract_head_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| contract_validity_img | String | 否 |
业务/合同有效期页
- 签名实名使用方为他人时需上传
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "contract_validity_img":"data:image/jpg;base64,/9j/4AAQSkZJR" |
| contract_tail_img | String | 否 |
合同尾页
- 签名实名使用方为他人时需上传
- 提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,jpeg 格式
| "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 | 是 |
验签
- 标准的 MD5 加密(32 位小写值)
- 加密规则:signature=md5(username+password+timestamp),无需+号,直接按照顺序拼接3个值进行MD5。双方进行校验。
| "signature":"e10adc3949ba59abbe56e057f20f883e" |
| api_name | String | 是 |
发短信的API账号
- 请填写对应的API账号
- 注:原sub_id和appid升级版参数,现在直接传对应的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"
}
没有更多了