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

中国站

创蓝云智

国际站

Innopaas

API接口

更新时间:2026-07-30 18:32:32

日期版本修订内容摘要
2024-07-30v2.0.0更新接口文档

1.闪测2.0API公共参数

本文罗列并说明 闪测2.0API设计的公共请求参数和返回参数

请求参数

下表为公共请求参数说明:

参数名请求类型类型是否必须示例值说明
appIdheaderString
appKeyheaderString

返回参数

对成功和异常返回的判断标准做出说明。同时,说明返回数据的格式(例如JSON/XML)。 下表为公共返回参数说明

参数名称类型示例值说明
codeinteger(int 32)状态码
dataString返回数据内容
messageString状态码信息

一、检测

1.单条短信检测

协议说明

名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/flashVP/query_diagnosis_single
并发说明50QPS(特殊需求联系运营)

1.2 请求参数

请求参数Body以multipart/form-data⽅式提交

参数名是否必须类型说明
appIdString请在https://www.chuanglan.com/登录后获取
appKeyString请在https://www.chuanglan.com/登录后获取
contentString检测短信内容,内容最大长度500个字符
smsSenderString短信运营商
brandsPercentString检测手机号品牌分布,例如:"华为":0.8,other":0.2

品牌分布key列表:

品牌名称描述
other其他,不确定的时候使用
apple苹果手机
huawei华为手机
vivovivo手机
oppooppo手机
honor荣耀手机
redmi红米手机
xiaomi小米手机
realme真我手机
oneplus一加手机
samsung三星手机
meizu魅族手机

1.3 响应内容

响应body数据为json格式

字段名类型说明
chargeStatusint是否收费,1:收费;0:不收费
codeString响应code码。200000:成功,其他失败。
messageString响应code码解释
dataObject
codeint状态码
dataString返回结果
messageString状态码描述

1.4 返回成功示例

{
  "chargeStatus": 1,
  "message": "请求成功",
  "data": {
    "code": 0,
    "data": "701117312634023936",
    "message": "SUCCESS"
  },
  "code": "200000"
}

1.5 返回失败示例

{
  "chargeStatus": 0,
  "message": "校验异常:检测内容不能为空",
  "code": "400001"
}

二、AIGG优化

1. 短信优化

1.1协议说明

名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/flashVP/query_diagnosis
并发说明50QPS(特殊需求联系运营)

1.2 请求参数

请求参数Body以multipart/form-data⽅式提交

参数名是否必须类型说明
appIdString请在https://www.chuanglan.com/登录后获取
appKeyString请在https://www.chuanglan.com/登录后获取
contentString检测短信内容:生成短信或优化短信
brandsPercentString检测手机号品牌分布,例如:"华为":0.8,other":0.2
smsCountString检测任务用户对生成的短信计费条数限制
coreWordsString检测内容固定词组,多条以英文逗号,拼接
contentString检测内容类型:0.生成短信1.优化短信 默认1
loopCountString短信优化内容最少循环次数
smsSenderString短信运营商

品牌分布key列表

品牌名称描述
other其他,不确定的时候使用
apple苹果手机
huawei华为手机
vivovivo手机
oppooppo手机
honor荣耀手机
redmi红米手机
xiaomi小米手机
realme真我手机
oneplus一加手机
samsung三星手机
meizu魅族手机

1.3 响应内容

响应body数据为JSON格式

字段名类型说明
chargeStatusint是否收费,1:收费;0:不收费
codeString响应code码。200000:成功,其他失败。
messageString响应code码解释
dataObject
codeint状态码
dataString返回结果
messageString状态码描述

1.4 返回成功示例

{
  "chargeStatus": 1,
  "message": "请求成功",
  "data": {
    "code": 0,
    "data": "701117312634023936",
    "message": "SUCCESS"
  },
  "code": "200000"
}

1.5 返回失败示例

{
  "chargeStatus": 0,
  "message": "校验异常:检测内容不能为空",
  "code": "400001"
}

2.失败的检测优化任务,重新发起诊断

协议说明

名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/flashVP/analysis/restart
并发说明50QPS(特殊需求联系运营)

2.1请求参数

请求参数Body以multipart/form-data⽅式提交

参数名是否必须类型说明
appIdString请在https://www.chuanglan.com/登录后获取
appKeyString请在https://www.chuanglan.com/登录后获取
taskIdInteger任务id

2.2响应内容

响应body数据为JSON格式

字段名类型说明
chargeStatusint是否收费,1:收费;0:不收费
codeString响应code码。200000:成功,其他失败。
messageString响应code码解释
dataString任务id

2.3返回成功示例

{
     "chargeStatus": 0,
     "message": "请求成功",
     "data": "710195537187254272",
     "code": "200000"

三、内容分析

1.内容分析

1.1 协议说明

名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/flashVP/text_analysis
并发说明50QPS(特殊需求联系运营)

1.2请求参数

请求参数Body以multipart/form-data⽅式提交

参数名是否必须类型说明
appIdString请在https://www.chuanglan.com/登录后获取
appKeyString请在https://www.chuanglan.com/登录后获取
taskIdInteger检测内容:生成短信或优化短信
brandsPercentString检测手机号品牌分布,例如:"huawei":0.8,"other""0.2"
smsCountString检测任务用户对生成的短信计费条数限制
coreWordsString检测内容固定词组,多条以英文逗号,拼接

1.3响应内容

响应body数据为JSON格式。

字段名类型说明
chargeStatusint是否收费,1:收费;0:不收费
codeString响应code码。200000:成功,其他失败。
messageString响应code码解释
dataString任务id

1.4返回成功示例

{
     "chargeStatus": 0,
     "message": "请求成功",
     "data": "710195537187254272",
     "code": "200000"

四、查询

1.查询历史检测任务

1.1协议说明

名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/flashVP/diagnosis_history
并发说明50QPS(特殊需求联系运营)

1.2请求参数

请求参数Body以multipart/form-data⽅式提交

参数名是否必须类型说明
appIdString请在https://www.chuanglan.com/登录后获取
appKeyString请在https://www.chuanglan.com/登录后获取
keywordInteger关键字
startTimeString开始时间,(yyyy-MM-dd HH:mm:ss)
endTimeString结束时间, (yyyy-MM-dd HH:mm:ss)
pageString当前页数,默认0
pageSizeString每页条数,默认10

1.3响应内容

响应body数据为JSON格式。

字段名类型说明
chargeStatusint是否收费,1:收费;0:不收费
codeString响应code码。200000:成功,其他失败。
messageString响应code码解释
dataObject
totalint总条数
listList返回列表
unknownRatedouble短信未知率
origSuccessRatedouble原始短信成功率
origInterceptRatedouble原始短信拦截率
successRatedouble短信成功率
smsCountint检测任务用户对生成的短信计费条数限制
updataTimelong更新时间
contentString检测任务用户使用的短信内容
loopCountint设置循环优化次数
loopedint已经循环优化次数
creatTimelong创建时间
appIdString用户应用id
interceptRatedouble短信拦截率
idlong任务id
contentTypeint检测内容类型:0.生成短信1.优化短信 默认0
statusint任务状态<0为任务失败
=0未开始任务
>0任务进行中
=3任务完成

1.4返回成功示例

{
   "chargeStatus": 0,
   "message": "请求成功",
    "data": {
       "total": 2,
       "list": [
           {
             "unknownRate": 0.0,
             "successRate": 0.9784742,
             "smsCount": 2,
             "updateTime": 1719217649000,
             "content": "测试⽣成短信或优化短信",
              "origSuccessRate": 0.9784742,
             "origInterceptRate": 0.0215258,
             "taskType": 0,
             "loopCount": 0,
             "createTime": 1719217642000,
             "appId": "XXXXXX",
             "looped": 1,
             "interceptRate": 0.0215258,
              "id": 725386597290954752,
             "contentType": 1,
             "status": 3
           },
           {
             "unknownRate": 0.0,
             "successRate": 0.9784742,
             "smsCount": 2,
             "updateTime": 1719217649000,
             "content": "测试⽣成短信或优化短信2",
             "origSuccessRate": 0.9784742,
             "origInterceptRate": 0.0215258,
              "taskType": 0,
             "loopCount": 0,
             "createTime": 1719217642000,
             "appId": "XXXXXX",
             "looped": 1,
             "interceptRate": 0.0215258,
             "id": 725386597290954752,
             "contentType": 1,
             "status": 3
         }
     ]
   },
   "code": "200000"

2.获取指定诊断任务记录列表

2.1协议说明

名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/flashVP/recordspage
并发说明50QPS(特殊需求联系运营)

2.2请求参数

请求参数Body以multipart/form-data⽅式提交

参数名是否必须类型说明
appIdString请在https://www.chuanglan.com/登录后获取
appKeyString请在https://www.chuanglan.com/登录后获取
taskIdString任务id

2.3响应内容

响应body数据为JSON格式

字段名类型说明
chargeStatusint是否收费,1:收费;0:不收费
codeString响应code码。200000:成功,其他失败。
messageString响应code码解释
dataObject
totalint总条数
listList返回列表
origContentStringAIGC优化前的内容
originalboolean诊断是否发送的AIGC优化前的内容
successRatedouble这次诊断的成功率
sinnatureString诊断原始内容的签名
teleNumberString诊断时所用的号码
typeString诊断的品牌
contentString诊断发送的内容
creatTimelong诊断记录创建爱你时间
interceptRatedouble这次诊断的拦截率
idlong诊断记录id
taskIdlong诊断id

2.4返回成功示例

{
  "chargeStatus": 0,
  "message": "请求成功",
  "data": {
    "total": 2,
    "list": [
      {
        "origContent": "测试⽣成短信或优化短信",
        "original": false,
        "successRate": 0.51890004,
        "signature": "短信",
        "teleNumber": "移动",
        "type": "other",
        "content": "【创蓝云智】信息 >> 测试⽣成短信或优化短信。请击信息 >> 下订单,www.abc.com获取详情。退订回T。",
        "createTime": 1702626771000,
        "interceptRate": 0.4811,
        "id": 655799439412289500,
        "taskId": 655796982531612700
      },
      {
        "origContent": "测试⽣成短信或优化短信",
        "original": false,
        "successRate": 0.51890004,
        "signature": "短信",
        "teleNumber": "移动",
        "type": "other",
        "content": "【创蓝云智】具体信息 >> 测试⽣成短信或优化短信。请击谨防过期 >> www.abc.com获取详情。退订回T。",
        "createTime": 1702626703000,
        "interceptRate": 0.4811,
        "id": 655799155118170100,
        "taskId": 655796982531612700
      }
    ]
  },
  "code": "200000"
}

3根据任务id查询检测记录详情(包括各个品牌信息,返回检测设备进度)

3.1协议说明

名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/flashVP/detail
并发说明50QPS(特殊需求联系运营)

3.2请求参数

请求参数Body以multipart/form-data⽅式提交

参数名是否必须类型说明
appIdString请在https://www.chuanglan.com/登录后获取
appKeyString请在https://www.chuanglan.com/登录后获取
taskIdString任务id

3.3响应内容

响应body数据为JSON格式

字段名类型说明
chargeStatusint是否收费,1:收费;0:不收费
codeString响应code码。200000:成功,其他失败。
messageString响应code码解释
dataList返回列表
successRatedouble这次诊断的成功率
deviceCountint需要检测的品牌数
checkCountint已经完成检测的品牌数
interceptRatedouble这次诊断的拦截率
brandinfoMap品牌分布信息
recordViewsList诊断激励详情列表
contentString诊断发送内容
createTimelong诊断记录创建时间
idlong
interceptRatedouble这次诊断的拦截率
originalContentStringAIGC优化前的内容
originalboolean诊断发送的内容
processint诊断原始内容的签名
signatureString这次诊断的拦截率
successRatedouble这次诊断的成功率
taskIdlong诊断记录id
teleNumberString诊断id
typeString诊断的品牌

3.4返回成功示例

{
  "chargeStatus": 0,
  "message": "请求成功",
  "data": [
    {
      "deviceCount": 15,
      "successRate": 1,
      "checkCount": 15,
      "brandinfo": {
        "xiaomi": 0.040039,
        "meizu": 0.000845,
        "honor": 0.092777,
        "oneplus": 0.008952,
        "apple": 0.319193,
        "huawei": 0.169605,
        "samsung": 0.00674,
        "realme": 0.014084,
        "oppo": 0.132436,
        "blackshark": 0.001654,
        "redmi": 0.050572,
        "vivo": 0.1525,
        "nzone": 0.000865,
        "hinova": 0.001372
      },
      "interceptRate": 0,
      "recordViews": [
        {
          "origContent": "测试",
          "original": true,
          "successRate": 1,
          "type": "apple",
          "content": "测试",
          "createTime": 1704695800000,
          "progress": 1,
          "interceptRate": 0,
          "id": 664477577455165400,
          "taskId": 664477575207018500
        },
        {
          "origContent": "测试",
          "original": true,
          "successRate": 1,
          "type": "huawei",
          "content": "测试",
          "createTime": 1704695800000,
          "progress": 1,
          "interceptRate": 0,
          "id": 664477577455165400,
          "taskId": 664477575207018500
        }
      ]
    }
  ],
  "code": "200000"
}

4.历史检测任务(状态查询)

4.1协议说明

该接⼝将基于历史任务的updateTime进⾏查询

名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/flashVP/diagnosis/list
并发说明50QPS(特殊需求联系运营)

4.2请求参数

请求参数Body以multipart/form-data⽅式提交

参数名是否必须类型说明
appIdString请在https://www.chuanglan.com/登录后获取
appKeyString请在https://www.chuanglan.com/登录后获取
startTimeString开始时间,(yyyy-MM-dd HH:mm:ss)
endTimeString结束时间, (yyyy-MM-dd HH:mm:ss)
pageString当前页数,默认0
pageSizeString每页条数,默认10

4.3响应内容

响应body数据为JSON格式

字段名类型说明
dataObject
totalint总条数
listList返回列表
messageString响应code码解释
dataobject
totalint总条数
listList返回列表
unknownRatedouble短信未知率
sinbatureString检测任务用户使用的短信签名
successRatedouble短信成功率
smsCountint检测任务用户对生成的短信计费条数限制
updataTimelong更新时间
contentString检测任务用户使用的短信内容
loopCountint已经循环优化次数
creatTimelong创建时间
appIdString用户应用id
goalRatedouble检测任务需要达标的阈值
interceptRatedouble短信拦截率
idlong任务id
contentTypeint检测内容类型:0.生成短信1.优化短信 默认0
statusint任务状态<0为任务失败
=0未开始任务
>0任务进行中
=3任务完成

4.4 返回成功示例

{
  "chargeStatus": 0,
  "message": "请求成功",
  "data": {
    "total": 2,
    "list": [
      {
        "unknownRate": 0,
        "signature": "短信",
        "successRate": 0,
        "smsCount": 2,
        "updateTime": 1702626378000,
        "content": "测试⽣成短信或优化短信",
        "loopCount": 0,
        "createTime": 1702626378000,
        "appId": "XXXXXX",
        "goalRate": 0.8,
        "interceptRate": 0,
        "id": 655797794288820200,
        "contentType": 1,
        "status": 0
      },
      {
        "unknownRate": 0,
        "signature": "短信",
        "successRate": 0,
        "smsCount": 1,
        "updateTime": 1702626703000,
        "content": "测试⽣成短信或优化短信2",
        "loopCount": 5,
        "createTime": 1702626185000,
        "appId": "XXXXXX",
        "goalRate": 0.8,
        "looped": 8,
        "interceptRate": 0,
        "id": 655796982531612700,
        "contentType": 1,
        "status": 2
      }
    ]
  },
  "code": "200000"
}

5.获取短信内容文本分析结果列表

5.1 协议说明

名称说明
协议HTTPS POST
编码格式UTF8
返回类型application/json
URLhttps://api.253.com/open/flashVP/analysis/list
并发说明50QPS(特殊需求联系运营)

5.2请求参数

请求参数Body以multipart/form-data⽅式提交

参数名是否必须类型说明
appIdString请在https://www.chuanglan.com/登录后获取
appKeyString请在https://www.chuanglan.com/登录后获取
taskIdString任务id

5.3响应内容

字段名类型说明
chargeStatusint是否收费,1:收费;0:不收费
codeString响应code码。200000:成功,其他失败。
messageString响应code码解释
dataList多个敏感词组,每组表示闪测敏感词后短信内容可以满足触达率要求,有可返回空数组,表示该短信内容绝大部分

5.4 返回成功示例

{
  "chargeStatus": 0,
  "message": "请求成功",
  "data": [
    [
      "⼀同",
      "联名",
      "抢",
      "来",
      "周边",
      "等",
      "奇幻",
      "世界",
      "戳"
    ],
    [
      "世界",
      "联名"
    ]
  ],
  "code": "200000"
}

闪测2.0公共错误码

本⽂罗列并说明公共错误码。若想了解某个接⼝业务逻辑相关的错误码,请参考该接⼝的说明⽂档。

状态码错误码错误信息说明
400请求参数错误
401请求Header错误
500未知错误服务出现故障
200100101拆分号码库失败
200100102号码库终端分布请求失败
200100103AIGC⽣成或优化内容失败
200100104诊断记录创建失败
200100107⽂件号码库不能为空
200100108loopCount⽣成短信时,最少检测优化1次
200100109历史诊断检测任务不存在
200100110⽆可下载的品牌分布数据
200100111诊断记录创建失败
200100112品牌分布格式错误,例如:"huawei":0.8,"other":0.2

异常返回⽰例:

{
  "code": 100104,
  "data": "",
  "message": "诊断记录创建失败"
}
24小时热线 400-9669-253