logo
logo
请输入关键词搜索产品或者文档
中国

中国站

创蓝云智

国际站

Innopaas

签名管理

更新时间:2026-07-30 15:48:38

更新时间:2026/4/10日 更新内容:添加签名接口的URL从V4更新到V5,主要修改了上传实名信息的逻辑,不再需要每次都上传实名信息,对接实名信息存档接口后后续只传ID。

接入准备

  • 1、请先联系商务开通"深度接口账号"才能使用本目录下所有接口。
  • 2、请登录控制台拿到发送短信的"API账号",添加签名根据API账号为导向的。
  • 3、应用场景材料:准备经办人授权书。
  • 4、实名信息:经办人身份证文字版、营业执照。
  • 5、签名的报备规范请遵循签名规范

接口列表

1、添加签名

1.1 请求地址

  • 请求方式:post
  • Content-Type:application/x-www-form-urlencoded
  • 请求地址:https://api.chuanglan.com/api/apis/v5/signature/signatureAdd

1.2 请求参数

参数名称类型是否必传描述示例
usernameString 深度接口账号名
  • 请联系创蓝商务提供
"username":"13899999999"
timestampString 时间戳
  • 10位时间戳
  • 时间戳1分钟过期
"timestamp":"1755068823"
signatureString 验签
  • 标准的 MD5 加密(32 位小写值)
  • 加密规则:signature=md5(username+password+timestamp),无需+号,直接按照顺序拼接3个值进行MD5。双方进行校验。
"signature":"e10adc3949ba59abbe56e057f20f883e"
api_nameString 发短信的API账号
  • 请填写对应的API账号
  • 注:原sub_id和appid升级版参数,现在直接传对应的API账号值即可
"api_name":"N617810_N7533106"
signature_nameString 短信签名
  • 不需要带中文括号,只包含括号里的文案
  • 长度限2-16个字符,中文、字母都算一个占位字符
  • 具体规范请参考签名规范
"signature_name":"253 云通讯"
end_customer_idLong 终端实名资质id
  • 实名信息存档查询接口返回的id,无需额外每次手动填写实名信息,新增存档实名信息后方便使用。
"end_customer_id":"123456"
signature_scene_typeInteger 应用场景
  • 传3:自用(签名为自己实名认证的企业事业单位、APP、商标等)
  • 传4:他用(签名为他人实名认证的企业事业单位、APP、商标等)
"signature_scene_type":3
sign_auth_imgString 签名授权书
  • 签名为“他用”时,签名授权书为必传
  • 提交base64处理后的数据
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
"sign_auth_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
sign_typeString 签名类型
  • 1:企业名称
  • 2:APP
  • 3:商标
  • 4:其他(如政企)
"sign_type":"1"
app_urlString APP/官网的链接
  • APP名称或官网访问地址
"app_url":"https://www.chuanglan.com"
app_imgString APP备案截图
  • 签名类型为APP时,该参数为必传
  • 提交base64处理后的数据
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
  • APP备案截图地址:https://beian.miit.gov.cn/#/Integrated/index
备案截图示例
"app_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
app_open_screenshot_imgString APP/小程序的首页截图
  • 签名类型为APP时,该参数为必传
  • 应用打开后,第一个页面截图
  • 提交base64处理后的数据
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
首页截图示例
"app_open_screenshot_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
company_unique_screenshot_imgString 企业唯一性截图
  • 签名类型为企业名称时,该参数为必传。
  • 信用代码非9其他组织机构:https://www.cods.org.cn/gscx/
  • 信用代码9开头工商企业:https://www.gsxt.gov.cn/index.html
企业唯一性截图示例
"company_unique_screenshot_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
sbj_screenshot_imgString 商标网截图
  • 签名类型为“商标”时,为必传
  • 提交base64处理后的数据
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
  • 商标网截图地址:https://sbj.cnipa.gov.cn/sbj/index.html
商标网截图示例
"sbj_screenshot_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
trademark_imgString 商标证截图
  • 各地市审核标准不同,部分通道需上传商标证书才可申诉成功,建议上传,详情可咨询商务风控确认。
  • 提交base64处理后的数据
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
商标证截图示例
"trademark_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
trademark_auth_imgString 商标使用授权书/许可备案
  • “商标网截图申请人名称”不等于“终端客户名称”时必填
  • 提交base64处理后的数据
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
"trademark_auth_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
institution_imgString 组织(政企)机构代码截图
  • 签名类型为“其他(政企)”时,为必传
  • 提交base64处理后的数据
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
  • 组织机构代码截图地址:https://www.cods.org.cn/gscx/
组织机构代码截图示例
"institution_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
additional_attachments_imgString[] 补充材料
  • 以数组格式提交base64处理后的数据,最多可上传9张图片
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
"additional_attachments_img[0]":"data:image/jpg;base64,/9j/4AAQSkZJR"
"additional_attachments_img[1]":"data:image/jpg;base64,/9j/4AAQSkZJR"

1.3 请求示例(换行易读,实际请求需删除换行)


username=13899999999&timestamp=1755068823&signature=e10adc3949ba59abbe56e057f20f883e&api_name=N617810_N7533106&signature_name=253 云通讯&
signature_scene_type=3&sign_type=1&app_img=data:image/jpg;base64,/9j/4AAQSkZJR&sbj_screenshot_img=data:image/jpg;base64,/9j/4AAQSkZJR&
trademark_img=data:image/jpg;base64,/9j/4AAQSkZJR&=data:image/jpg;base64,/9j/4AAQSkZJR&sign_auth_img=data:image/jpg;base64,/9j/4AAQSkZJR&
additional_attachments_img[0]=data:image/jpg;base64,/9j/4AAQSkZJR&additional_attachments_img[1]=data:image/jpg;base64,/9j/4AAQSkZJR&
app_url=https://www.chuanglan.com&end_customer_id=123456

1.4 响应参数(JSON格式,中文部分需Unicode字符解码)

参数名类型默认值描述
codeString000000 代表成功,其他代表失败,会有 message 错误信息返回
statusString状态说明 success:成功,error:失败
msgString提示信息(Unicode字符编码,需自行解码为中文)
dataobject返回数据
-idInteger签名 id
-existed_idInteger已存在的签名所对应的签名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 请求参数

参数名称类型是否必传描述示例
usernameString 深度接口账号名
  • 由创蓝商务提供
"username":"13899999999"
timestampString 时间戳
  • 10位时间戳
  • 时间戳1分钟过期
"timestamp":"1755068823"
signatureString 验签
  • 标准的 MD5 加密(32 位小写值)
  • 加密规则:signature=md5(username+password+timestamp),无需+号,直接按照顺序拼接3个值进行MD5。双方进行校验。
"signature":"e10adc3949ba59abbe56e057f20f883e"
api_nameString 发短信的API账号
  • 请填写对应的API账号
  • 注:原sub_id和appid升级版参数,现在直接传对应的API账号值即可
"api_name":"N617810_N7533106"
startInteger 偏移量
  • 表示从第几页开始查询,默认为0(即第一页)
"start":0
lengthInteger 分页大小
  • 表示每页显示的签名个数
  • 默认为10,仅支持选择10、20、50、100这4个值
"length":10
signature_nameString 模糊查询签名名称
  • 搜索关键词为签名名称中包含的字符(如搜索“张三”,则匹配所有含“张三”的签名)
  • 展示数量由start和length参数控制
"signature_name":"张三"
signature_statusString 平台审核签名状态
  • 1:未审核
  • 2:审核通过
  • 3:审核驳回
  • -1:历史签名
"signature_status":"2"

2.3 请求示例


username=17321332052&timestamp=1659584150&signature=2d68b71096508ae6b921cea4ca2c62e6&api_name=N123&start=0&length=10

2.4 响应参数(JSON格式,中文部分需Unicode字符解码)

参数名类型默认值描述
codeString000000 代表成功,其他代表失败,会有 message 错误信息返回
statusString状态说明 success:成功,error:失败
msgString提示信息(Unicode字符编码,需自行解码为中文)
totalInteger列表总数
dataobject返回数据
listobject []item 类型: object
-is_system_signatureString是否为默认签名:0:普通签名,1:默认签名
-operator_statusnumber运营商审核签名状态 1:未审核,2:审核通过,3:审核驳回
-signature_idString签名 id
-signature_nameString签名名称(Unicode字符编码,需自行解码为中文)
-signature_statusString平台审核签名状态 1:未审核,2:审核通过,3:审核驳回,-1:历史签名
-real_name_statusString实名修改状态 0:未修改实名状态,1:审核中,2:审核通过,3:审核驳回
-company_nameString公司名(Unicode 字符编码,需自行解码为中文)
-company_license_noString社会统一代码
-legal_nameString法人姓名(Unicode 字符编码,需自行解码为中文)
-identity_noString经办人身份证号
-identity_nameString经办人姓名(Unicode 字符编码,需自行解码为中文)
-phone_numString经办人手机号
-end_customer_idString终端实名资质 id(实名信息存档后资质标识,用于新增签名使用)
-cm_operator_statusString移动运营商审核签名状态 1:未审核,2:审核通过,3:审核驳回,-1:查询失败
-ct_operator_statusString电信运营商审核签名状态 1:未审核,2:审核通过,3:审核驳回,-1:查询失败
-cu_operator_statusString联通运营商审核签名状态 1:未审核,2:审核通过,3:审核驳回,-1:查询失败

返回数据示例(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",
        "company_name": "某某科技有限公司",
        "company_license_no": "91110108XXXXXXXXXX",
        "legal_name": "张三",
        "identity_no": "11010119900101XXXX",
        "identity_name": "李四",
        "phone_num": "13888888888",
        "end_customer_id": "T20260304001"
      },
      {
        "is_system_signature": "0",
        "operator_status": 2,
        "signature_id": "340215",
        "real_name_status": 2,
        "signature_name": "常量签名 02",
        "signature_status": "2",
        "company_name": "某某信息技术有限公司",
        "company_license_no": "91110109XXXXXXXXXX",
        "legal_name": "王五",
        "identity_no": "11010219910202XXXX",
        "identity_name": "赵六",
        "phone_num": "13988888888",
        "end_customer_id": "T20260304002"
      }
    ],
    "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 请求参数

参数名称类型是否必传描述示例
usernameString 深度接口账号名
  • 由创蓝商务提供
"username":"13899999999"
timestampString 时间戳
  • 10位时间戳
  • 时间戳1分钟过期
"timestamp":"1755068823"
signatureString 验签
  • 标准的 MD5 加密(32 位小写值)
  • 加密规则:signature=md5(username+password+timestamp),无需+号,直接按照顺序拼接3个值进行MD5。双方进行校验。
"signature":"e10adc3949ba59abbe56e057f20f883e"
api_nameString 发短信的API账号
  • 请填写对应的API账号
  • 注:原sub_id和appid升级版参数,现在直接传对应的API账号值即可
"api_name":"N617810_N7533106"
idInteger 签名 id
  • 对应待操作的签名唯一标识ID
"id":123456

3.3 请求示例


username=17321332052&timestamp=1659584250&signature=63c8f97e69a30497ab576123d10316ff&api_name=N123&id=341708

3.4 响应参数(JSON格式,中文部分需Unicode字符解码)

参数名类型默认值描述
codeString000000 代表成功,其他代表失败,会有 message 错误信息返回
statusString状态说明 success:成功,error:失败
msgString提示信息(Unicode字符编码,需自行解码为中文)
dataobject返回信息
-is_system_signatureString是否为默认签名:0 普通签名,1 默认签名
-signature_idString签名 id
-signature_nameString短信签名名称(Unicode字符编码,需自行解码为中文)
-signature_statusString平台审核签名状态 1:未审核,2:审核通过,3:审核驳回,-1:历史签名
-operator_statusnumber运营商审核签名状态 1:未审核,2:审核通过,3:审核驳回
-real_name_statusString实名修改状态 0:未修改实名状态,1:审核中,2:审核通过,3:审核驳回
-audit_reasonString审核驳回的状态才有该参数,审核驳回的具体原因。(Unicode字符编码,需自行解码为中文)
-real_name_audit_reasonString实名修改审核驳回的状态才有该参数,审核驳回的具体原因。(Unicode字符编码,需自行解码为中文)
-cm_operator_statusString移动运营商审核签名状态 1:未审核,2:审核通过,3:审核驳回,-1:查询失败
-ct_operator_statusString电信运营商审核签名状态 1:未审核,2:审核通过,3:审核驳回,-1:查询失败
-cu_operator_statusString联通运营商审核签名状态 1:未审核,2:审核通过,3:审核驳回,-1:查询失败
-cm_operator_reject_reasonList移动运营商审核驳回原因集合
--issue_typeInteger问题类型,1:签名问题,2:签名材料问题,3:终端资质问题,4:其他,5:引流问题
--issue_descString问题描述
--operation_recommendString操作建议
--modify_modulesString修改模块,1:新增终端资质,2:变更签名终端资质,3:修改签名材料 a,4:变更签名类型,5:新增签名,6:修改链接材料,7:修改联系方式材料,8:无需修改
-cu_operator_reject_reasonList联通运营商审核驳回原因集合
--issue_typeInteger问题类型,1:签名问题,2:签名材料问题,3:终端资质问题,4:其他,5:引流问题
--issue_descString问题描述
--operation_recommendString操作建议
--modify_modulesString修改模块,1:新增终端资质,2:变更签名终端资质,3:修改签名材料 a,4:变更签名类型,5:新增签名,6:修改链接材料,7:修改联系方式材料,8:无需修改
-ct_operator_reject_reasonList电信运营商审核驳回原因集合
--issue_typeInteger问题类型,1:签名问题,2:签名材料问题,3:终端资质问题,4:其他,5:引流问题
--issue_descString问题描述
--operation_recommendString操作建议
--modify_modulesString修改模块,1:新增终端资质,2:变更签名终端资质,3:修改签名材料 a,4:变更签名类型,5:新增签名,6:修改链接材料,7:修改联系方式材料,8:无需修改

返回数据示例(JSON):

{
  "code": "000000",
  "status": "success",
  "msg": "查询签名信息成功",
  "data": {
    "is_system_signature": "0",
    "signature_id": "31257",
    "signature_name": "深度接口 v6 子账号 00333",
    "signature_status": "3",
    "operator_status": 3,
    "real_name_status": "3",
    "audit_reason": "该签名行业属性不符合规定的发送要求。",
    "real_name_audit_reason": "实名提交资质文件模糊无法识别",
    "cm_operator_status": "3",
    "ct_operator_status": "3",
    "cu_operator_status": "3",
    "cm_operator_reject_reason": [
      {
        "issue_type": 1,
        "issue_desc": "签名名称包含违规敏感字符",
        "operation_recommend": "修改签名名称后重新提交审核",
        "modify_modules": "5"
      }
    ],
    "cu_operator_reject_reason": [
      {
        "issue_type": 3,
        "issue_desc": "终端资质材料缺失有效期截图",
        "operation_recommend": "补充完整终端资质材料",
        "modify_modules": "1"
      }
    ],
    "ct_operator_reject_reason": [
      {
        "issue_type": 2,
        "issue_desc": "上传营业执照边角裁切不全",
        "operation_recommend": "重新上传完整清晰营业执照",
        "modify_modules": "3"
      }
    ]
  }
}

4、编辑签名

注意事项:

  • 该接口只能修改签名绑定的实名资质以及应用场景,且只有平台审核通过状态下才可以调用。驳回和未审核状态下无法使用,如需修改请删除签名后重建。
  • 修改绑定的信息时,您当前主管理员账号下的所有主、子账号下的这个签名会连同全部一起修改。

4.1 请求地址

  • 请求方式:post
  • Content-Type:application/x-www-form-urlencoded
  • 请求地址:https://api.chuanglan.com/api/apis/v3/signature/realNameModify

4.2 请求参数

参数名称类型是否必传描述示例
usernameString 深度接口账号名
  • 请联系创蓝商务提供
"username":"13899999999"
timestampString 时间戳
  • 10位时间戳
  • 时间戳1分钟过期
"timestamp":"1755068823"
signatureString 验签
  • 标准的 MD5 加密(32 位小写值)
  • 加密规则:signature=md5(username+password+timestamp),无需+号,直接按照顺序拼接3个值进行MD5。双方进行校验。
"signature":"e10adc3949ba59abbe56e057f20f883e"
api_nameString 发短信的API账号
  • 请填写对应的API账号
  • 注:原sub_id和appid升级版参数,现在直接传对应的API账号值即可
"api_name":"N617810_N7533106"
idString 签名id
  • 添加签名时返回的签名id。
"id":"123456"
typeString 修改类型
  • 传2:修改实名资质
  • 传3:修改应用场景
"type":"2"
end_customer_idLong 终端实名资质id
  • 实名资质存档查询接口返回的id,无需额外每次手动填写实名信息,新增存档实名资质后方便使用。
"end_customer_id":"123456"
signature_scene_typeInteger 应用场景
  • type修改类型参数传3时,该参数为必传。
  • 传3:自用(签名为自己实名认证的企业事业单位、APP、商标等)
  • 传4:他用(签名为他人实名认证的企业事业单位、APP、商标等)
"signature_scene_type":3
sign_auth_imgString 签名授权书
  • 选择修改应用场景时,且签名为“他用”时,该参数为必传。
  • 提交base64处理后的数据
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
"sign_auth_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
app_imgString APP备案截图
  • 签名类型为APP时,并选择修改应用场景时,该参数为必传。
  • 提交base64处理后的数据
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
  • APP备案截图地址:https://beian.miit.gov.cn/#/Integrated/index
备案截图示例
"app_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
app_open_screenshot_imgString APP/小程序的首页截图
  • 签名类型为APP时,并选择修改应用场景时,该参数为必传。
  • 应用打开后,第一个页面截图
  • 提交base64处理后的数据
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
首页截图示例
"app_open_screenshot_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
company_unique_screenshot_imgString 企业唯一性截图
  • 签名类型为企业名称时,并选择修改应用场景时,该参数为必传。
  • 信用代码非9其他组织机构:https://www.cods.org.cn/gscx/
  • 信用代码9开头工商企业:https://www.gsxt.gov.cn/index.html
企业唯一性截图示例
"company_unique_screenshot_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
sbj_screenshot_imgString 商标网截图
  • 签名类型为“商标”时,并选择修改应用场景时,该参数为必传
  • 提交base64处理后的数据
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
  • 商标网截图地址:https://sbj.cnipa.gov.cn/sbj/index.html
商标网截图示例
"sbj_screenshot_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
trademark_imgString 商标证截图
  • 签名类型为“商标”时,并选择修改应用场景时,该参数为必传。
  • 各地市审核标准不同,部分通道需上传商标证书才可申诉成功,建议上传,详情可咨询商务风控确认。
  • 提交base64处理后的数据
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
商标证截图示例
"trademark_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
trademark_auth_imgString 商标使用授权书/许可备案
  • 签名类型为“商标”时,并选择修改应用场景时,以及“商标网截图申请人名称”不等于“终端客户名称”时必填
  • 提交base64处理后的数据
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
"trademark_auth_img":"data:image/jpg;base64,/9j/4AAQSkZJR"
institution_imgString 组织(政企)机构代码截图
  • 签名类型为“其他(政企)”时,并选择修改应用场景时,该参数为必传。
  • 提交base64处理后的数据
  • 每张图片不大于2M,支持 png、jpg、jpeg 格式
  • 组织机构代码截图地址:https://www.cods.org.cn/gscx/
组织机构代码截图示例
"institution_img":"data:image/jpg;base64,/9j/4AAQSkZJR"

4.3 请求示例(换行易读,实际请求需删除换行)


username=17321332052&timestamp=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

4.4 响应参数(JSON格式,中文部分需Unicode字符解码)

参数名类型默认值描述
codeString000000 代表成功,其他代表失败,会有 message 错误信息返回
statusString状态说明 success:成功,error:失败
msgString提示信息(Unicode字符编码,需自行解码为中文)

返回数据示例(JSON):

{
  "code": "000000",
  "msg": "深度接口修改签名实名信息成功",
  "status": "success"
}

5、签名删除

5.1 请求地址

  • 请求方式:post
  • Content-Type:application/x-www-form-urlencoded
  • 请求地址:https://api.chuanglan.com/api/apis/signature/del

5.2 请求参数

参数名称类型是否必传描述示例
usernameString 深度接口账号名
  • 请联系创蓝商务提供
"username":"13899999999"
timestampString 时间戳
  • 10位时间戳
  • 时间戳1分钟过期
"timestamp":"1755068823"
signatureString 验签
  • 标准的 MD5 加密(32 位小写值)
  • 加密规则:signature=md5(username+password+timestamp),无需+号,直接按照顺序拼接3个值进行MD5。双方进行校验。
"signature":"e10adc3949ba59abbe56e057f20f883e"
api_nameString 发短信的API账号
  • 请填写对应的API账号
  • 注:原sub_id和appid升级版参数,现在直接传对应的API账号值即可
"api_name":"N617810_N7533106"
idString 签名id
  • 添加签名时返回的签名id。
"id":"123456"

5.3 请求示例


username=17321332052&timestamp=1659584250&signature=63c8f97e69a30497ab576123d10316ff&api_name=N123&id=341708

5.4 响应参数(JSON格式,中文部分需Unicode字符解码)

参数名类型默认值描述
codeString000000 代表成功,其他代表失败,会有 message 错误信息返回
statusString状态说明 success:成功,error:失败
msgString提示信息(Unicode字符编码,需自行解码为中文)

返回数据示例(JSON):

{
  "code": "000000",
  "msg": "深度接口签名删除成功",
  "status": "success"
}

6、审核结果推送

6.1 推送方式

  • 回调方式:post
  • Content-Type:application/x-www-form-urlencoded
  • 审核回调地址:深度接口回调地址请联系对应商务配置和查询。

注:推送会有 15 分钟左右的延迟,有定时任务一起推送。

10.2 推送参数

参数名称类型描述示例
usernameString 深度接口账号名
  • 请联系创蓝商务提供
"username":"13899999999"
timestampString 时间戳
  • 10位时间戳
"timestamp":"1755068823"
signatureString 验签
  • 标准的 MD5 加密(32 位小写值)
  • 加密规则:signature=md5(username+password+timestamp),无需+号,直接按照顺序拼接3个值进行MD5。双方进行校验。
"signature":"e10adc3949ba59abbe56e057f20f883e"
actionString 功能类型
  • smsSignature(签名)、messageModel(模板)
"action":"smsSignature"
idString 签名 id 或者 模板 id
  • 添加签名或模板时返回的 id,纯数字
"id":"123456"
auditStatusString 审核结果
  • 模板(1 通过,2 驳回)
  • 签名(2 通过,3 驳回)
"auditStatus":"3"
auditReasonString 驳回时的原因
  • 如:此签名为测试签名,请修改成常规签名测试。
  • 如果审核结果是通过,该参数为空值。
"auditReason":"此签名为测试签名,请修改成常规签名测试"

6.3 推送数据示例:

{
  "username": "cl13908446911",
  "timestamp": "1702971183",
  "signature": "8e563949655a851c34a71ac2c5f4a542",
  "action": "smsSignature",
  "id": "593965",
  "auditStatus": "3",
  "auditReason": "此签名为测试签名,请修改成常规签名测试"
}

提交响应码说明

序号参数说明问题处理人
1cl0000未知错误对接技术
2cl0001参数不全对接技术
3cl0002传过来的时间戳与服务器时间误差在 10s 以上对接技术
4cl0003接口账号不存在商务
5cl0004签名不正确对接技术
6cl0005非法操作对接技术
7cl9999未知错误对接技术
8cl0101内容含有敏感词客服
9cl0102营销短信缺少退订信息对接技术
10cl0103营销短信退订信息输入错误对接技术
11cl0104当前产品账号未激活对接技术
12cl0201分配权限格式不正确对接技术
13cl0202请选择用途类型对接技术
14cl0203账号用途长度为 1-50 字符对接技术
15cl0204姓名为数字字母中文且不超过 8 个字对接技术
16cl0205部门为数字字母中文且不超过 8 个字对接技术
17cl0206职位为数字字母中文且不超过 8 个字对接技术
18cl0207账号为非中文 6-20 个字符对接技术
19cl0208密码为非中文 6-16 个字符对接技术
20cl0209该账户已被占用客服
21cl0210当前账号对应的自助通账号不存在商务
22cl0211子账号个数超过限制,请联系客服客服
23cl0212子账号创建失败对接技术
24cl0213当前子账号不存在对接技术
25cl0214子账号没有该权限对接技术
26cl0215该应用已激活对接技术
27cl0216当前账号没有完成信息认证对接技术
28cl0217激活失败对接技术
29cl0218额度只能为正整数对接技术
30cl0219该应用未激活对接技术
31cl0220余额不足无法充值商务
32cl0221子账号余额不足无法转回商务
33cl0222条数调拨失败商务
34cl0301当前应用未激活对接技术
35cl0302签名长度为 2-10 个字符对接技术
36cl0303开启审核提醒的情况下,接收手机号必须客服
37cl0304至少选择一项应用场景客服
38cl0305应用场景名称为 2-30 个字符对接技术
39cl0306签名个数达到上限商务
40cl0307添加签名失败对接技术
41cl0308查询列表最大长度为 100对接技术
42cl0309当前签名不存在对接技术
43cl0310该签名已经被添加模板,请先删除对应的模板客服
44cl0311删除签名失败对接技术
45cl0312当前签名已存在客服
46cl0401查询列表最大长度为 100对接技术
47cl0402当前应用未激活对接技术
48cl0501查询列表最大长度为 100对接技术
49cl0502当前应用未激活对接技术
50cl0503查询状态参数不合法对接技术
24小时热线 400-9669-253