文档更新时间:2025/07/21
更新内容:添加签名和编辑签名的接口URL从V3更新到V4,主要修改参数为logo图片参数,新增了支持上传签名授权书。
接入准备
1、请先联系商务开通"深度接口账号"才能使用本目录下所有接口。
2、请登录控制台拿到发送短信的"API账号",添加签名根据API账号为导向的。
3、应用场景材料:准备经办人授权书。
4、实名信息:经办人身份证文字版、营业执照。
注意事项
1、调用接口修改实名信息时,您当前主管理员账号下的所有主、子账号下跟当前被修改的签名名称一样时,会连同全部一起修改。
2、添加签名或修改签名,都需要审核人员审核通过。如需催审请联系官网在线客服。
3、签名的报备规范请遵循签名规范。
接口列表
1、添加签名
1.1 请求地址
- 请求方式:post
- Content-Type:application/x-www-form-urlencoded
- 请求地址:
https://api.chuanglan.com/api/apis/v4/signature/signatureAdd
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" |
| signature_scene_type | Integer | 是 |
应用场景
- 传3:代表签名为自己产品名/网站名/APP 名称等
- 传4:代表签名为他人产品名/网站名等
| "signature_scene_type":3 |
| sign_type | String | 是 |
签名类型
- 1:企业名称
- 2:APP
- 3:商标
- 4:其他(如政企)
| "sign_type":"1" |
| logo | String | 是 |
图片
- 以数组格式提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,gif,jpeg 格式
- 签名类型为app:经办人授权书、APP备案截图、签名授权书(场景为他人签名则需要)
- 签名类型为企业名称:经办人授权书、签名授权书(场景为他人签名则需要)
- 签名类型为商标:经办人授权书、商标证书、签名授权书(场景为他人签名则需要)
- 签名类型为其他(政企):经办人授权书、组织机构代码截图、签名授权书(场景为他人签名则需要)
| "logo[0]": "data:image/jpg;base64,/9j/4AAQSkZJR", "logo[1]": "data:image/jpg;base64,/9j/4AAQSkZJR", "logo[2]": "data:image/jpg;base64,/9j/4AAQSkZJR" |
| signature_name | String | 是 |
短信签名
- 不需要带中文括号,只包含括号里的文案
- 长度限2-16个字符,中文、字母都算一个占位字符
- 具体规范请参考签名规范
| "signature_name":"253 云通讯" |
| is_online | Integer | 是 |
是否上线
- 传1:代表已上线,仅支持已上线的签名报备
- 已上线要求:需要上传 app 名称或者官网地址,详情看web_site和app参数
| "is_online":1 |
| web_site | String | 否 |
官网网址
- 签名类型为商标、企业名称、app时,为必填字段(与app参数选填一个)
- 签名类型为其它(如政企)则非必填
| "web_site":"https://www.chuanglan.com" |
| app | String | 否 |
app 名称
- 可在应用商城能够搜到,APP应在工信部信息备案管理系统中可查,且该APP的ICP备案主体和签名资质主体一致。
- 签名类型为商标、企业名称、app时,为必填字段(与web_site参数选填一个)
- 签名类型为其它(如政企)则非必填
| "app":"创蓝云通讯" |
| 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" |
| remind_type | String | 否 |
审核结果通知方式
| "remind_type":"1" |
| remind_phone | Integer | 否 |
提醒手机
| "remind_phone":13512345678 |
1.3 请求示例(换行易读,实际请求需删除换行)
username=17321332052×tamp=1659583889&signature=f3ecceccfb68922930e3f139b599477e&api_name=M123456&signature_name=创蓝云智&signature_scene_type=3&is_online=1&
logo[0]=data:image/jpg;base64,/9j/4AAQSkZJR&logo[1]=data:image/jpg;base64,/9j/4AAQSkZJR&logo[2]=data:image/jpg;base64,/9j/4AAQSkZJR&app=创蓝小程序&
enterprise_name=上海创蓝云智信息科技股份有限公司&unified_social_credit_code=913101165727226313&attention_line=张三&attention_id_card=4300000000000000000&remind_type=0&remind_phone=0
1.4 响应参数(JSON格式,中文部分需Unicode字符解码)
| 参数名 | 类型 | 默认值 | 描述 |
|---|
| code | String | | 000000 代表成功,其他代表失败,会有 message 错误信息返回 |
| status | String | | 状态说明 success:成功,error:失败 |
| msg | String | | 提示信息(Unicode字符编码,需自行解码为中文) |
| data | object | | 返回数据 |
| -id | Integer | | 签名 id |
| -existed_id | Integer | | 已存在的签名所对应的签名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/signature/list
2.1 请求参数
| 参数名称 | 类型 | 是否必传 | 描述 | 示例 |
|---|
| 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" |
| start | Integer | 否 |
偏移量
| "start":0 |
| length | Integer | 否 |
分页大小
- 表示每页显示的签名个数
- 默认为10,仅支持选择10、20、50、100这4个值
| "length":10 |
| signature_name | String | 否 |
模糊查询签名名称
- 搜索关键词为签名名称中包含的字符(如搜索"张三",则匹配所有含"张三"的签名)
- 展示数量由start和length参数控制
| "signature_name":"张三" |
| signature_status | String | 否 |
平台审核签名状态
- 1:未审核
- 2:审核通过
- 3:审核驳回
- -1:历史签名
| "signature_status":"2" |
2.3 请求示例
username=17321332052×tamp=1659584150&signature=2d68b71096508ae6b921cea4ca2c62e6&api_name=N123&start=0&length=10
2.4 响应参数(JSON格式,中文部分需Unicode字符解码)
| 参数名 | 类型 | 默认值 | 描述 |
|---|
| code | String | | 000000 代表成功,其他代表失败,会有 message 错误信息返回 |
| status | String | | 状态说明 success:成功,error:失败 |
| msg | String | | 提示信息(Unicode字符编码,需自行解码为中文) |
| total | Integer | | 列表总数 |
| data | object | | 返回数据 |
| list | object [] | | item 类型: object |
| -is_system_signature | String | | 是否为默认签名:0:普通签名,1:默认签名 |
| -operator_status | number | | 运营商审核签名状态 1:未审核,2:审核通过,3:审核驳回 |
| -signature_id | String | | 签名 id |
| -signature_name | String | | 签名名称(Unicode字符编码,需自行解码为中文) |
| -signature_status | String | | 平台审核签名状态 1:未审核,2:审核通过,3:审核驳回,-1:历史签名 |
| -real_name_status | String | | 实名修改状态 0:未修改实名状态,1:审核中,2:审核通过,3:审核驳回 |
返回数据示例(JSON):
{
"code": "000000",
"data": {
"list": [
{ "is_system_signature": "0","operator_status":2, "signature_id": "341708","real_name_status":2, "signature_name": "深度接口测试 1111", "signature_status": "1" },
{ "is_system_signature": "0","operator_status":2, "signature_id": "340215","real_name_status":2, "signature_name": "常量签名 02", "signature_status": "2" },
{ "is_system_signature": "1","operator_status":2, "signature_id": "318409","real_name_status":2, "signature_name": "常量签名 01", "signature_status": "2" },
{ "is_system_signature": "0","operator_status":2, "signature_id": "301312","real_name_status":2, "signature_name": "测试未上线签名 0706", "signature_status": "2" },
{ "is_system_signature": "0","operator_status":2, "signature_id": "296483","real_name_status":2, "signature_name": "0531 测试自助通 V6", "signature_status": "2" }
],
"total": 10
},
"msg": "深度接口签名列表查询成功",
"status": "success"
}
3、签名 id 查询
3.1 请求地址
- 请求方式:post
- Content-Type:application/x-www-form-urlencoded
- 请求地址:
https://api.chuanglan.com/api/apis/signature/getSingleSignatureInfo
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" |
| id | Integer | 是 |
签名 id
| "id":123456 |
3.3 请求示例
username=17321332052×tamp=1659584250&signature=63c8f97e69a30497ab576123d10316ff&api_name=N123&id=341708
3.4 响应参数(JSON格式,中文部分需Unicode字符解码)
| 参数名 | 类型 | 默认值 | 描述 |
|---|
| code | String | | 000000 代表成功,其他代表失败,会有 message 错误信息返回 |
| status | String | | 状态说明 success:成功,error:失败 |
| msg | String | | 提示信息(Unicode字符编码,需自行解码为中文) |
| data | object | | 返回信息 |
| -is_system_signature | String | | 是否为默认签名:0 普通签名,1 默认签名 |
| -signature_id | String | | 签名 id |
| -signature_name | String | | 短信签名名称(Unicode字符编码,需自行解码为中文) |
| -signature_status | String | | 平台审核签名状态 1:未审核,2:审核通过,3:审核驳回,-1:历史签名 |
| -operator_status | number | | 运营商审核签名状态 1:未审核,2:审核通过,3:审核驳回 |
| -real_name_status | String | | 实名修改状态 0:未修改实名状态,1:审核中,2:审核通过,3:审核驳回 |
| -audit_reason | String | | 审核驳回的状态才有该参数,审核驳回的具体原因。(Unicode字符编码,需自行解码为中文) |
返回数据示例(JSON):
{
"code": "000000",
"data": {
"is_system_signature": "0",
"signature_id":"31257",
"signature_name":"深度接口 v6 子账号 00333",
"signature_status":"2",
"operator_status":"2",
"audit_reason":"该签名行业属性不符合规定的发送要求。"
},
"msg": "深度接口根据 id 查询签名成功",
"status": "success"
}
4、签名编辑
- 注意事项:调用接口修改实名信息时,您当前主管理员账号下的所有主、子账号下跟当前被修改的签名名称一样时,会连同全部一起修改。
4.1 请求地址
- 请求方式:post
- Content-Type:application/x-www-form-urlencoded
- 请求地址:
https://api.chuanglan.com/api/apis/v3/signature/signatureModify
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" |
| signature_scene_type | Integer | 是 |
应用场景
- 传3:代表签名为自己产品名/网站名/APP 名称等
- 传4:代表签名为他人产品名/网站名等
| "signature_scene_type":3 |
| sign_type | String | 是 |
签名类型
- 1:企业名称
- 2:APP
- 3:商标
- 4:其他(如政企)
| "sign_type":"1" |
| logo | String | 是 |
图片
- 以数组格式提交base64处理后的数据
- 每张图片不大于2M,支持 png,jpg,gif,jpeg 格式
- 签名类型为app:经办人授权书、APP备案截图、签名授权书(场景为他人签名则需要)
- 签名类型为企业名称:经办人授权书、签名授权书(场景为他人签名则需要)
- 签名类型为商标:经办人授权书、商标证书、签名授权书(场景为他人签名则需要)
- 签名类型为其他(政企):经办人授权书、组织机构代码截图、签名授权书(场景为他人签名则需要)
| "logo[0]": "data:image/jpg;base64,/9j/4AAQSkZJR", "logo[1]": "data:image/jpg;base64,/9j/4AAQSkZJR", "logo[2]": "data:image/jpg;base64,/9j/4AAQSkZJR" |
| signature_name | String | 是 |
短信签名
- 不需要带中文括号,只包含括号里的文案
- 长度限2-16个字符,中文、字母都算一个占位字符
- 具体规范请参考签名规范
| "signature_name":"253 云通讯" |
| is_online | Integer | 是 |
是否上线
- 传1:代表已上线,仅支持已上线的签名报备
- 已上线要求:需要上传 app 名称或者官网地址,详情看web_site和app参数
| "is_online":1 |
| web_site | String | 否 |
官网网址
- 签名类型为商标、企业名称、app时,为必填字段(与app参数选填一个)
- 签名类型为其它(如政企)则非必填
| "web_site":"https://www.chuanglan.com" |
| app | String | 否 |
app 名称
- 可在应用商城能够搜到,APP应在工信部信息备案管理系统中可查,且该APP的ICP备案主体和签名资质主体一致。
- 签名类型为商标、企业名称、app时,为必填字段(与web_site参数选填一个)
- 签名类型为其它(如政企)则非必填
| "app":"创蓝云通讯" |
| 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" |
| remind_type | String | 否 |
审核结果通知方式
| "remind_type":"1" |
| remind_phone | Integer | 否 |
提醒手机
| "remind_phone":13512345678 |
4.3 请求示例(换行易读,实际请求需删除换行)
username=17321332052×tamp=1659583889&signature=f3ecceccfb68922930e3f139b599477e&api_name=N123&signature_name=创蓝云智&signature_scene_type=3&is_onlone=1&
logo[0]=data:image/jpg;base64,/9j/4AAQSkZJR&logo[1]=data:image/jpg;base64,/9j/4AAQSkZJR&app=创蓝小程序&remind_type=0&remind_phone=0
4.4 响应参数(JSON格式,中文部分需Unicode字符解码)
| 参数名 | 类型 | 默认值 | 描述 |
|---|
| code | String | | 000000 代表成功,其他代表失败,会有 message 错误信息返回 |
| status | String | | 状态说明 success:成功,error:失败 |
| msg | String | | 提示信息(Unicode字符编码,需自行解码为中文) |
返回数据示例(JSON):
{
"code": "000000",
"msg": "深度接口签名修改成功 ",
"status": "success"
}
5、编辑签名实名信息
注意事项:
- 调用接口修改实名信息时,您当前主管理员账号下的所有主、子账号下跟当前被修改的签名名称一样时,会连同全部一起修改。
- 该接口只能修改实名信息,如需修改场景等其他信息,请调用签名编辑接口。
5.1 请求地址
- 请求方式:post
- Content-Type:application/x-www-form-urlencoded
- 请求地址:
https://api.chuanglan.com/api/apis/v2/signature/realNameModify
5.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" |
| id | String | 是 |
签名id
| "id":"123456" |
| 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" |
| remind_type | String | 否 |
审核结果通知方式
| "remind_type":"1" |
| remind_phone | Integer | 否 |
提醒手机
| "remind_phone":13512345678 |
5.3 请求示例(换行易读,实际请求需删除换行)
username=17321332052×tamp=1659583889&signature=f3ecceccfb68922930e3f139b599477e&api_name=N123456&id=123456&
real_name_text_img_flag=0&real_name_logo[0]=data:image/jpg;base64,/9j/4AAQSkZJR&real_name_logo[1]=data:image/jpg;base64,/9j/4AAQSkZJR&enterprise_name=创蓝云智科技&
unified_social_credit_code=123456&attention_line=李先生&attention_id_card=123456&legal_name=王先生&phone_num=139xxxxxxx
5.4 响应参数(JSON格式,中文部分需Unicode字符解码)
| 参数名 | 类型 | 默认值 | 描述 |
|---|
| code | String | | 000000 代表成功,其他代表失败,会有 message 错误信息返回 |
| status | String | | 状态说明 success:成功,error:失败 |
| msg | String | | 提示信息(Unicode字符编码,需自行解码为中文) |
返回数据示例(JSON):
{
"code": "000000",
"msg": "深度接口修改签名实名信息成功",
"status": "success"
}
6、签名删除
6.1 请求地址
- 请求方式:post
- Content-Type:application/x-www-form-urlencoded
- 请求地址:
https://api.chuanglan.com/api/apis/signature/del
6.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" |
| id | String | 是 |
签名id
| "id":"123456" |
6.3 请求示例
username=17321332052×tamp=1659584250&signature=63c8f97e69a30497ab576123d10316ff&api_name=N123&id=341708
6.4 响应参数(JSON格式,中文部分需Unicode字符解码)
| 参数名 | 类型 | 默认值 | 描述 |
|---|
| code | String | | 000000 代表成功,其他代表失败,会有 message 错误信息返回 |
| status | String | | 状态说明 success:成功,error:失败 |
| msg | String | | 提示信息(Unicode字符编码,需自行解码为中文) |
返回数据示例(JSON):
{
"code": "000000",
"msg": "深度接口签名删除成功",
"status": "success"
}
7、存档实名信息新增
7.1 请求地址
- 请求方式:post
- Content-Type:application/x-www-form-urlencoded
- 请求地址:
https://api.chuanglan.com/api/apis/signature/realNameInfoAdd
7.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" |
| 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" |
| for_self | String | 否 |
应用场景范围
| "remind_type":"1" |
7.3 请求示例(换行易读,实际请求需删除换行)
username=17321332052×tamp=1659583889&signature=f3ecceccfb68922930e3f139b599477e&api_name=N123&enterprise_name=上海创蓝云智信息科技股份有限公司&
unified_social_credit_code=913101165727226313&attention_line=张三&attention_id_card=4300000000000000000&legal_name=李四&phone_num=138xxxxxxxx
7.4 响应参数
| 参数名 | 类型 | 默认值 | 描述 |
|---|
| code | String | | 000000 代表成功,其他代表失败,会有 message 错误信息返回 |
| status | String | | 状态说明 success:成功,error:失败 |
| msg | String | | 提示信息(Unicode字符编码,需自行解码为中文) |
| data | object | | 返回数据 |
8、存档实名信息查询
8.1 请求地址
- 请求方式:post
- Content-Type:application/x-www-form-urlencoded
- 请求地址:
https://api.chuanglan.com/api/apis/signature/realNameInfoList
8.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" |
| company_name | String | 是 |
企业名称
| "enterprise_name":"上海创蓝云智信息科技股份有限公司" |
| for_self | String | 否 |
应用场景范围
| "for_self":"1" |
8.3 请求示例
username=17321332052×tamp=1659583889&signature=f3ecceccfb68922930e3f139b599477e&api_name=N123456
8.4 响应参数
| 参数名 | 类型 | 描述 |
|---|
| code | String | 000000 代表成功,其他代表失败,会有 message 错误信息返回 |
| status | String | 状态说明 success:成功,error:失败 |
| msg | String | 提示信息(Unicode字符编码,需自行解码为中文) |
| data | object | 返回数据 |
| list | object [] | item 类型: object |
| -enterprise_name | String | 企业名称 |
| -unified_social_credit_code | String | 统一社会信用代码 |
| -attention_line | String | 经办人姓名 |
| -attention_id_card | String | 经办人身份证号 |
| -legal_name | String | 法人姓名 |
| -phone_num | String | 经办人手机号 |
9、审核结果推送
9.1 推送方式
- 回调方式:post
- Content-Type:application/x-www-form-urlencoded
- 审核回调地址:深度接口回调地址请联系对应商务配置和查询。
注:推送会有 15 分钟左右的延迟,有定时任务一起推送。
9.2 推送参数
| 参数名称 | 类型 | 描述 | 示例 |
|---|
| username | String |
深度接口账号名
| "username":"13899999999" |
| timestamp | String |
时间戳
| "timestamp":"1755068823" |
| signature | String |
验签
- 标准的 MD5 加密(32 位小写值)
- 加密规则:signature=md5(username+password+timestamp),无需+号,直接按照顺序拼接3个值进行MD5。双方进行校验。
| "signature":"e10adc3949ba59abbe56e057f20f883e" |
| action | String |
功能类型
- smsSignature(签名)、messageModel(模板)
| "action":"smsSignature" |
| id | String |
签名 id 或者 模板 id
| "id":"123456" |
| auditStatus | String |
审核结果
- 模板(1 通过,2 驳回)
- 签名(2 通过,3 驳回)
| "auditStatus":"3" |
| auditReason | String |
驳回时的原因
- 如:此签名为测试签名,请修改成常规签名测试。
- 如果审核结果是通过,该参数为空值。
| "auditReason":"此签名为测试签名,请修改成常规签名测试" |
9.3 推送数据示例:
{
"username":"cl13908446911",
"timestamp":"1702971183",
"signature":"8e563949655a851c34a71ac2c5f4a542",
"action":"smsSignature",
"id":"593965",
"auditStatus":"3",
"auditReason":"此签名为测试签名,请修改成常规签名测试"
}
提交响应码说明
| 序号 | 参数 | 说明 | 问题处理人 |
|---|
| 1 | cl0000 | 未知错误 | 对接技术 |
| 2 | cl0001 | 参数不全 | 对接技术 |
| 3 | cl0002 | 传过来的时间戳与服务器时间误差在 10s 以上 | 对接技术 |
| 4 | cl0003 | 接口账号不存在 | 商务 |
| 5 | cl0004 | 签名不正确 | 对接技术 |
| 6 | cl0005 | 非法操作 | 对接技术 |
| 7 | cl9999 | 未知错误 | 对接技术 |
| 8 | cl0101 | 内容含有敏感词 | 客服 |
| 9 | cl0102 | 营销短信缺少退订信息 | 对接技术 |
| 10 | cl0103 | 营销短信退订信息输入错误 | 对接技术 |
| 11 | cl0104 | 当前产品账号未激活 | 对接技术 |
| 12 | cl0201 | 分配权限格式不正确 | 对接技术 |
| 13 | cl0202 | 请选择用途类型 | 对接技术 |
| 14 | cl0203 | 账号用途长度为 1-50 字符 | 对接技术 |
| 15 | cl0204 | 姓名为数字字母中文且不超过 8 个字 | 对接技术 |
| 16 | cl0205 | 部门为数字字母中文且不超过 8 个字 | 对接技术 |
| 17 | cl0206 | 职位为数字字母中文且不超过 8 个字 | 对接技术 |
| 18 | cl0207 | 账号为非中文 6-20 个字符 | 对接技术 |
| 19 | cl0208 | 密码为非中文 6-16 个字符 | 对接技术 |
| 20 | cl0209 | 该账户已被占用 | 客服 |
| 21 | cl0210 | 当前账号对应的自助通账号不存在 | 商务 |
| 22 | cl0211 | 子账号个数超过限制,请联系客服 | 客服 |
| 23 | cl0212 | 子账号创建失败 | 对接技术 |
| 24 | cl0213 | 当前子账号不存在 | 对接技术 |
| 25 | cl0214 | 子账号没有该权限 | 对接技术 |
| 26 | cl0215 | 该应用已激活 | 对接技术 |
| 27 | cl0216 | 当前账号没有完成信息认证 | 对接技术 |
| 28 | cl0217 | 激活失败 | 对接技术 |
| 29 | cl0218 | 额度只能为正整数 | 对接技术 |
| 30 | cl0219 | 该应用未激活 | 对接技术 |
| 31 | cl0220 | 余额不足无法充值 | 商务 |
| 32 | cl0221 | 子账号余额不足无法转回 | 商务 |
| 33 | cl0222 | 条数调拨失败 | 商务 |
| 34 | cl0301 | 当前应用未激活 | 对接技术 |
| 35 | cl0302 | 签名长度为 2-10 个字符 | 对接技术 |
| 36 | cl0303 | 开启审核提醒的情况下,接收手机号必须 | 客服 |
| 37 | cl0304 | 至少选择一项应用场景 | 客服 |
| 38 | cl0305 | 应用场景名称为 2-30 个字符 | 对接技术 |
| 39 | cl0306 | 签名个数达到上限 | 商务 |
| 40 | cl0307 | 添加签名失败 | 对接技术 |
| 41 | cl0308 | 查询列表最大长度为 100 | 对接技术 |
| 42 | cl0309 | 当前签名不存在 | 对接技术 |
| 43 | cl0310 | 该签名已经被添加模板,请先删除对应的模板 | 客服 |
| 44 | cl0311 | 删除签名失败 | 对接技术 |
| 45 | cl0312 | 当前签名已存在 | 客服 |
| 46 | cl0401 | 查询列表最大长度为 100 | 对接技术 |
| 47 | cl0402 | 当前应用未激活 | 对接技术 |
| 48 | cl0501 | 查询列表最大长度为 100 | 对接技术 |
| 49 | cl0502 | 当前应用未激活 | 对接技术 |
| 50 | cl0503 | 查询状态参数不合法 | 对接技术 |
没有更多了