API接口
更新时间:2026-08-03 11:58:20
| 日期 | 版本 | 修订内容摘要 |
|---|---|---|
| 2025-12-8 | v1.0.0 | 更新接口文档 |
1.短信优化
1.1 协议说明
| 名称 | 说明 |
|---|---|
| 协议 | HTTPS POST |
| 编码格式 | UTF8 |
| 返回类型 | application/json |
| URL | https://api.253.com/open/flashVP/query_diagnosis |
| 并发说明 | 50QPS(特殊需求联系运营) |
1.2 请求参数
请求参数Body以multipart/form-data方式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| content | 是 | String | 检测内容:生成短信或优化短信 |
| smsCount | 否 | String | 检测任务用户对生成的短信计费条数限制 |
| contentType | 否 | String | 检测内容类型:0.生成短信 1.优化短信 默认0 |
| loopCount | 否 | String | 短信优化内容循环次数 |
| signature | 否 | String | 签名 |
| smsSender | 否 | String | 短信运营商 |
| type | 否 | String | 1.md5(32位小写) 0.普通手机号 默认0 |
| file | 否 | File | 检测手机号,多个手机号码,文本格式:每行一个号码 |
1.3 响应内容
响应body数据为JSON格式。
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费,1:收费;0:不收费 |
| code | String | 响应code码。200000:成功,其他失败。 |
| message | String | 响应code码解释 |
| data | Object | |
| code | int | 状态码 |
| data | String | 返回结果 |
| message | String | 状态码描述 |
1.4 返回成功示例
{
"chargeStatus": 1,
"message": "请求成功",
"data": {
"code": 0,
"data": "SUCCESS",
"message": "SUCCESS"
},
"code": "200000"
}1.5 返回失败示例
{
"chargeStatus": 0,
"message": "校验异常:检测内容不能为空",
"code": "400001"
}2. 短信诊断
2.1 协议说明
| 名称 | 说明 |
|---|---|
| 协议 | HTTPS POST |
| 编码格式 | UTF8 |
| 返回类型 | application/json |
| URL | https://api.253.com/open/flashVP/query_diagnosis_single |
| 并发说明 | 50QPS(特殊需求联系运营) |
2.2 请求参数
请求参数Body以multipart/form-data方式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| content | 是 | String | 检测短信内容 |
| smsCount | 否 | String | 检测任务用户对生成的短信计费条数限制 |
| signature | 否 | String | 签名 |
| smsSender | 否 | String | 短信运营商 |
| type | 否 | String | 1.md5(32位小写) 0.普通手机号 默认0 |
| file | 否 | File | 检测手机号,多个手机号码,文本格式:每行一个号码 |
2.3 响应内容
响应body数据为JSON格式。
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费,1:收费;0:不收费 |
| code | String | 响应code码。200000:成功,其他失败。 |
| message | String | 响应code码解释 |
| data | Object | |
| code | int | 状态码 |
| data | String | 返回结果 |
| message | String | 状态码描述 |
2.4 返回成功示例
{
"chargeStatus": 1,
"message": "请求成功",
"data": {
"code": 0,
"data": "SUCCESS",
"message": "SUCCESS"
},
"code": "200000"
}2.5 返回失败示例
{
"chargeStatus": 0,
"message": "校验异常:检测内容不能为空",
"code": "400001"
}3. 查询历史检测任务
3.1 协议说明
| 名称 | 说明 |
|---|---|
| 协议 | HTTPS POST |
| 编码格式 | UTF8 |
| 返回类型 | application/json |
| URL | https://api.253.com/open/flashVP/diagnosis_history |
| 并发说明 | 50QPS(特殊需求联系运营) |
3.2 请求参数
请求参数Body以multipart/form-data方式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| keyword | 否 | String | 关键字 |
| startTime | 否 | String | 开始时间(yyyy-MM-dd HH:mm:ss) |
| endTime | 否 | String | 结束时间(yyyy-MM-dd HH:mm:ss) |
| page | 否 | String | 当前⻚数,默认0 |
| pageSize | 否 | String | 每⻚条数,默认10 |
3.3 响应内容
响应body数据为JSON格式。
| 字段名 | 类型 | 说明 |
|---|---|---|
| data | Object | |
| total | int | 总条数 |
| list | List | 返回列表 |
| message | String | 响应code码解释 |
| data | Object | |
| total | int | 总条数 |
| list | List | 返回列表 |
| unknownRate | double | 短信未知率 |
| signature String | 检测任务⽤户使⽤的短信签名 | |
| successRate | double | 短信成功率 |
| smsCount | int | 检测任务⽤户对⽣成的短信计费条数限制 |
| updateTime | long | 更新时间 |
| content | String | 检测任务⽤户使⽤的短信内容 |
| loopCount | int | 已经循环优化次数 |
| createTime | long | 创建时间 |
| appId | String | ⽤户应⽤id |
| goalRate | double | 检测任务需要达标的阈值 |
| interceptRate | double | 短信拦截率 |
| id | long 任务id | |
| contentType | int | 检测内容类型:0.⽣成短信 1.优化短信 默认0 |
| status | int | 任务状态 |
3.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"
}4. 根据任务id查询⼿机⼚商查询诊断业务
4.1 协议说明
| 名称 | 说明 |
|---|---|
| 协议 | HTTPS POST |
| 编码格式 | UTF8 |
| 返回类型 | application/json |
| URL | https://api.253.com/open/flashVP/diagnoserecords |
| 并发说明 | 50QPS(特殊需求联系运营) |
4.2 请求参数
请求参数Body以multipart/form-data方式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| id | 是 | String | 任务id |
| type | 否 | String | ⼿机⼚商 |
4.3 响应内容
响应body数据为JSON格式。
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费,1:收费;0:不收费 |
| code | String | 响应code码。200000:成功,其他失败。 |
| message | String | 响应code码解释 |
| data | List | 返回列表 |
| origContent | String | AIGC优化前的内容 |
| original | boolean | 诊断是否发送的AIGC优化前的内容 |
| successRate | double | 这次诊断的成功率 |
| signature | String | 诊断原始内容的签名 |
| teleNumber | String | 诊断时所⽤号码 |
| type | String | 诊断的品牌 |
| content | String | 诊断发送的内容 |
| createTime | long | 诊断记录创建时间 |
| interceptRate | double | 这次诊断的拦截率 |
| id | long | 诊断记录id |
| taskId | long | 诊断任务id |
4.4 返回成功示例
{
"chargeStatus": 0,
"message": "请求成功",
"data": [
{
"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"
}5. 获取指定诊断任务和⼚商中最好的记录
5.1 协议说明
| 名称 | 说明 |
|---|---|
| 协议 | HTTPS POST |
| 编码格式 | UTF8 |
| 返回类型 | application/json |
| URL | https://api.253.com/open/flashVP/diagnoserecords/best |
| 并发说明 | 50QPS(特殊需求联系运营) |
5.2 请求参数
请求参数Body以multipart/form-data方式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| id | 是 | String | 任务id |
| type | 否 | String | ⼿机⼚商 |
5.3 响应内容
响应body数据为JSON格式。
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费,1:收费;0:不收费 |
| code | String | 响应code码。200000:成功,其他失败。 |
| message | String | 响应code码解释 |
| data | List | 返回列表 |
| origContent | String | AIGC优化前的内容 |
| original | boolean | 诊断是否发送的AIGC优化前的内容 |
| successRate | double | 这次诊断的成功率 |
| signature | String | 诊断原始内容的签名 |
| teleNumber | String | 诊断时所⽤号码 |
| type | String | 诊断的品牌 |
| content | String | 诊断发送的内容 |
| createTime | long | 诊断记录创建时间 |
| interceptRate | double | 这次诊断的拦截率 |
| id | long | 诊断记录id |
| taskId | long | 诊断任务id |
5.4 返回成功示例
{
"chargeStatus": 0,
"message": "请求成功",
"data": [
{
"origContent": "测试生成短信或优化短信",
"original": false,
"successRate": 0.51890004,
"signature": "短信",
"teleNumber": "移动",
"type": "other",
"content": "【创蓝云智】测试生成短信或优化短信,请注意本次测试内容符合要求,无需修改。www.abc.com退R.",
"createTime": 1702626222000,
"interceptRate": 0.4811,
"id": 655797138974957600,
"taskId": 655796982531612700
}
],
"code": "200000"
}6. 获取指定诊断任务记录列表
6.1 协议说明
| 名称 | 说明 |
|---|---|
| 协议 | HTTPS POST |
| 编码格式 | UTF8 |
| 返回类型 | application/json |
| URL | https://api.253.com/open/flashVP/recordspage |
| 并发说明 | 50QPS(特殊需求联系运营) |
6.2 请求参数
请求参数Body以multipart/form-data方式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| id | 是 | String | 任务id |
| page | 否 | String | 当前⻚数,默认0 |
| pageSize | 否 | String | 每⻚条数,默认10 |
6.3 响应内容
响应body数据为JSON格式。
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费,1:收费;0:不收费 |
| code | String | 响应code码。200000:成功,其他失败。 |
| message | String | 响应code码解释 |
| data | Object | |
| total | int | 总条数 |
| list | List | 返回列表 |
| origContent | String | AIGC优化前的内容 |
| original | boolean | 诊断是否发送的AIGC优化前的内容 |
| successRate | double | 这次诊断的成功率 |
| signature | String | 诊断原始内容的签名 |
| teleNumber | String | 诊断时所⽤号码 |
| type | String | 诊断的品牌 |
| content | String | 诊断发送的内容 |
| createTime | long | 诊断记录创建时间 |
| interceptRate | double | 这次诊断的拦截率 |
| id | long | 诊断记录id |
| taskId | long | 诊断任务id |
6.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"
}7. 批量删除诊断任务
7.1 协议说明
| 名称 | 说明 |
|---|---|
| 协议 | HTTPS POST |
| 编码格式 | UTF8 |
| 返回类型 | application/json |
| URL | https://api.253.com/open/flashVP/delete_diagnosis |
| 并发说明 | 50QPS(特殊需求联系运营) |
7.2 请求参数
请求参数Body以multipart/form-data方式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| ids | 是 | String | 任务id,多个以逗号隔开 |
7.3 响应内容
响应body数据为JSON格式。
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费,1:收费;0:不收费 |
| code | String | 响应code码。200000:成功,其他失败。 |
| message | String | 响应code码解释 |
| data | List | 删除的任务id列表 |
7.4 返回成功示例
{
"chargeStatus": 0,
"message": "请求成功",
"data": [
655796982531612700
],
"code": "200000"
}8. 批量删除诊断记录
8.1 协议说明
| 名称 | 说明 |
|---|---|
| 协议 | HTTPS POST |
| 编码格式 | UTF8 |
| 返回类型 | application/json |
| URL | https://api.253.com/open/flashVP/delete_diagnoserecords |
| 并发说明 | 50QPS(特殊需求联系运营) |
8.2 请求参数
请求参数Body以multipart/form-data方式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| ids | 是 | String | 任务id,多个以逗号隔开 |
8.3 响应内容
响应body数据为JSON格式。
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费,1:收费;0:不收费 |
| code | String | 响应code码。200000:成功,其他失败。 |
| message | String | 响应code码解释 |
| data | List | 删除的任务id列表 |
8.4 返回成功示例
{
"chargeStatus": 0,
"message": "请求成功",
"data": [
655797138454863872
],
"code": "200000"
}
```-->
| 日期 | 版本 | 修订内容摘要 |
| -------- | ----------------------------------------------------------- |---------- |
| 2024-07-30 | v2.0.0 | 更新接口文档|
## 1.闪测2.0API公共参数
本文罗列并说明 闪测2.0API设计的公共请求参数和返回参数
### 请求参数
下表为公共请求参数说明:
<style>
.sms-auth-header-scroll-table {
width: 100%;
max-width: 100%;
overflow: hidden;
}
.sms-auth-header-scroll-table .markdown-table-scroll {
display: block !important;
width: 100% !important;
max-width: 100% !important;
margin: 16px 0 !important;
overflow-x: auto !important;
overflow-y: hidden !important;
-webkit-overflow-scrolling: touch;
overscroll-behavior-x: contain;
}
.sms-auth-header-scroll-table .markdown-table-scroll > table {
width: 700px !important;
min-width: 700px !important;
max-width: none !important;
table-layout: fixed !important;
}
.sms-auth-header-scroll-table th {
white-space: nowrap !important;
}
.sms-auth-header-scroll-table td {
white-space: normal !important;
overflow-wrap: anywhere !important;
word-break: break-word !important;
}
</style>
<div class="sms-auth-header-scroll-table">
<table>
<colgroup>
<col style="width:100px;">
<col style="width:100px;">
<col style="width:90px;">
<col style="width:100px;">
<col style="width:120px;">
<col style="width:190px;">
</colgroup>
<thead>
<tr>
<th>参数名</th>
<th>请求类型</th>
<th>类型</th>
<th>是否必须</th>
<th>示例值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="white-space:nowrap!important;">appId</td>
<td style="white-space:nowrap!important;">header</td>
<td style="white-space:nowrap!important;">String</td>
<td style="white-space:nowrap!important;">是</td>
<td></td>
<td></td>
</tr>
<tr>
<td style="white-space:nowrap!important;">appKey</td>
<td style="white-space:nowrap!important;">header</td>
<td style="white-space:nowrap!important;">String</td>
<td style="white-space:nowrap!important;">是</td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
</div>
### 返回参数
对成功和异常返回的判断标准做出说明。同时,说明返回数据的格式(例如JSON/XML)。
下表为公共返回参数说明
| 参数名称 | 类型 | 示例值 | 说明
| --- | --- | --- | --- |
| code | integer(int 32) | |状态码
| data | String | |返回数据内容
| message | String | |状态码信息
## 一、检测
### 1.单条短信检测
协议说明
| 名称 | 说明 |
| --- | --- |
| 协议 | HTTPS POST |
| 编码格式 | UTF8 |
| 返回类型 | application/json |
| URL | https://api.253.com/open/flashVP/query_diagnosis_single|
| 并发说明 | 50QPS(特殊需求联系运营) |
#### 1.2 请求参数
请求参数Body以multipart/form-data⽅式提交
| 参数名 | 是否必须 | 类型 | 说明 |
| --- | --- | --- | --- |
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取
| content | 是 | String | 检测短信内容,内容最大长度500个字符
| smsSender | 否 | String | 短信运营商
| brandsPercent | 否 | String | 检测手机号品牌分布,例如:"华为":0.8,other":0.2|
#### 品牌分布key列表:
| 品牌名称 | 描述 |
| --- | ---
| other | 其他,不确定的时候使用
| apple | 苹果手机
| huawei | 华为手机
| vivo | vivo手机
| oppo | oppo手机
|honor |荣耀手机
|redmi |红米手机
|xiaomi |小米手机
|realme |真我手机
|oneplus |一加手机
|samsung |三星手机
|meizu |魅族手机
#### 1.3 响应内容
响应body数据为json格式
| 字段名 | 类型| 说明
| --- | --- | --- |
| chargeStatus| int | 是否收费,1:收费;0:不收费
| code | String| 响应code码。200000:成功,其他失败。
| message | String| 响应code码解释
| data | Object|
| code |int |状态码
| data |String |返回结果
| message |String |状态码描述
#### 1.4 返回成功示例
```json
{
"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 |
| URL | https://api.253.com/open/flashVP/query_diagnosis |
| 并发说明 | 50QPS(特殊需求联系运营) |
1.2 请求参数
请求参数Body以multipart/form-data⽅式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| content | 是 | String | 检测短信内容:生成短信或优化短信 |
| brandsPercent | 否 | String | 检测手机号品牌分布,例如:"华为":0.8,other":0.2 |
| smsCount | 否 | String | 检测任务用户对生成的短信计费条数限制 |
| coreWords | 否 | String | 检测内容固定词组,多条以英文逗号,拼接 |
| content | 否 | String | 检测内容类型:0.生成短信1.优化短信 默认1 |
| loopCount | 否 | String | 短信优化内容最少循环次数 |
| smsSender | 否 | String | 短信运营商 |
品牌分布key列表
| 品牌名称 | 描述 |
|---|---|
| other | 其他,不确定的时候使用 |
| apple | 苹果手机 |
| huawei | 华为手机 |
| vivo | vivo手机 |
| oppo | oppo手机 |
| honor | 荣耀手机 |
| redmi | 红米手机 |
| xiaomi | 小米手机 |
| realme | 真我手机 |
| oneplus | 一加手机 |
| samsung | 三星手机 |
| meizu | 魅族手机 |
1.3 响应内容
响应body数据为JSON格式
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费,1:收费;0:不收费 |
| code | String | 响应code码。200000:成功,其他失败。 |
| message | String | 响应code码解释 |
| data | Object | |
| code | int | 状态码 |
| data | String | 返回结果 |
| message | String | 状态码描述 |
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 |
| URL | https://api.253.com/open/flashVP/analysis/restart |
| 并发说明 | 50QPS(特殊需求联系运营) |
2.1请求参数
请求参数Body以multipart/form-data⽅式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| taskId | 是 | Integer | 任务id |
2.2响应内容
响应body数据为JSON格式
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费,1:收费;0:不收费 |
| code | String | 响应code码。200000:成功,其他失败。 |
| message | String | 响应code码解释 |
| data | String | 任务id |
2.3返回成功示例
{
"chargeStatus": 0,
"message": "请求成功",
"data": "710195537187254272",
"code": "200000"
三、内容分析
1.内容分析
1.1 协议说明
| 名称 | 说明 |
|---|---|
| 协议 | HTTPS POST |
| 编码格式 | UTF8 |
| 返回类型 | application/json |
| URL | https://api.253.com/open/flashVP/text_analysis |
| 并发说明 | 50QPS(特殊需求联系运营) |
1.2请求参数
请求参数Body以multipart/form-data⽅式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| taskId | 是 | Integer | 检测内容:生成短信或优化短信 |
| brandsPercent | 否 | String | 检测手机号品牌分布,例如:"huawei":0.8,"other""0.2" |
| smsCount | 否 | String | 检测任务用户对生成的短信计费条数限制 |
| coreWords | 否 | String | 检测内容固定词组,多条以英文逗号,拼接 |
1.3响应内容
响应body数据为JSON格式。
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费,1:收费;0:不收费 |
| code | String | 响应code码。200000:成功,其他失败。 |
| message | String | 响应code码解释 |
| data | String | 任务id |
1.4返回成功示例
{
"chargeStatus": 0,
"message": "请求成功",
"data": "710195537187254272",
"code": "200000"
四、查询
1.查询历史检测任务
1.1协议说明
| 名称 | 说明 |
|---|---|
| 协议 | HTTPS POST |
| 编码格式 | UTF8 |
| 返回类型 | application/json |
| URL | https://api.253.com/open/flashVP/diagnosis_history |
| 并发说明 | 50QPS(特殊需求联系运营) |
1.2请求参数
请求参数Body以multipart/form-data⽅式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| keyword | 否 | Integer | 关键字 |
| startTime | 否 | String | 开始时间,(yyyy-MM-dd HH:mm:ss) |
| endTime | 否 | String | 结束时间, (yyyy-MM-dd HH:mm:ss) |
| page | 否 | String | 当前页数,默认0 |
| pageSize | 否 | String | 每页条数,默认10 |
1.3响应内容
响应body数据为JSON格式。
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费,1:收费;0:不收费 |
| code | String | 响应code码。200000:成功,其他失败。 |
| message | String | 响应code码解释 |
| data | Object | |
| total | int | 总条数 |
| list | List | 返回列表 |
| unknownRate | double | 短信未知率 |
| origSuccessRate | double | 原始短信成功率 |
| origInterceptRate | double | 原始短信拦截率 |
| successRate | double | 短信成功率 |
| smsCount | int | 检测任务用户对生成的短信计费条数限制 |
| updataTime | long | 更新时间 |
| content | String | 检测任务用户使用的短信内容 |
| loopCount | int | 设置循环优化次数 |
| looped | int | 已经循环优化次数 |
| creatTime | long | 创建时间 |
| appId | String | 用户应用id |
| interceptRate | double | 短信拦截率 |
| id | long | 任务id |
| contentType | int | 检测内容类型:0.生成短信1.优化短信 默认0 |
| status | int | 任务状态<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 |
| URL | https://api.253.com/open/flashVP/recordspage |
| 并发说明 | 50QPS(特殊需求联系运营) |
2.2请求参数
请求参数Body以multipart/form-data⽅式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| taskId | 是 | String | 任务id |
2.3响应内容
响应body数据为JSON格式
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费,1:收费;0:不收费 |
| code | String | 响应code码。200000:成功,其他失败。 |
| message | String | 响应code码解释 |
| data | Object | |
| total | int | 总条数 |
| list | List | 返回列表 |
| origContent | String | AIGC优化前的内容 |
| original | boolean | 诊断是否发送的AIGC优化前的内容 |
| successRate | double | 这次诊断的成功率 |
| sinnature | String | 诊断原始内容的签名 |
| teleNumber | String | 诊断时所用的号码 |
| type | String | 诊断的品牌 |
| content | String | 诊断发送的内容 |
| creatTime | long | 诊断记录创建爱你时间 |
| interceptRate | double | 这次诊断的拦截率 |
| id | long | 诊断记录id |
| taskId | long | 诊断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 |
| URL | https://api.253.com/open/flashVP/detail |
| 并发说明 | 50QPS(特殊需求联系运营) |
3.2请求参数
请求参数Body以multipart/form-data⽅式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| taskId | 是 | String | 任务id |
3.3响应内容
响应body数据为JSON格式
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费,1:收费;0:不收费 |
| code | String | 响应code码。200000:成功,其他失败。 |
| message | String | 响应code码解释 |
| data | List | 返回列表 |
| successRate | double | 这次诊断的成功率 |
| deviceCount | int | 需要检测的品牌数 |
| checkCount | int | 已经完成检测的品牌数 |
| interceptRate | double | 这次诊断的拦截率 |
| brandinfo | Map | 品牌分布信息 |
| recordViews | List | 诊断激励详情列表 |
| content | String | 诊断发送内容 |
| createTime | long | 诊断记录创建时间 |
| id | long | |
| interceptRate | double | 这次诊断的拦截率 |
| originalContent | String | AIGC优化前的内容 |
| original | boolean | 诊断发送的内容 |
| process | int | 诊断原始内容的签名 |
| signature | String | 这次诊断的拦截率 |
| successRate | double | 这次诊断的成功率 |
| taskId | long | 诊断记录id |
| teleNumber | String | 诊断id |
| type | String | 诊断的品牌 |
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 |
| URL | https://api.253.com/open/flashVP/diagnosis/list |
| 并发说明 | 50QPS(特殊需求联系运营) |
4.2请求参数
请求参数Body以multipart/form-data⽅式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| startTime | 否 | String | 开始时间,(yyyy-MM-dd HH:mm:ss) |
| endTime | 否 | String | 结束时间, (yyyy-MM-dd HH:mm:ss) |
| page | 否 | String | 当前页数,默认0 |
| pageSize | 否 | String | 每页条数,默认10 |
4.3响应内容
响应body数据为JSON格式
| 字段名 | 类型 | 说明 |
|---|---|---|
| data | Object | |
| total | int | 总条数 |
| list | List | 返回列表 |
| message | String | 响应code码解释 |
| data | object | |
| total | int | 总条数 |
| list | List | 返回列表 |
| unknownRate | double | 短信未知率 |
| sinbature | String | 检测任务用户使用的短信签名 |
| successRate | double | 短信成功率 |
| smsCount | int | 检测任务用户对生成的短信计费条数限制 |
| updataTime | long | 更新时间 |
| content | String | 检测任务用户使用的短信内容 |
| loopCount | int | 已经循环优化次数 |
| creatTime | long | 创建时间 |
| appId | String | 用户应用id |
| goalRate | double | 检测任务需要达标的阈值 |
| interceptRate | double | 短信拦截率 |
| id | long | 任务id |
| contentType | int | 检测内容类型:0.生成短信1.优化短信 默认0 |
| status | int | 任务状态<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 |
| URL | https://api.253.com/open/flashVP/analysis/list |
| 并发说明 | 50QPS(特殊需求联系运营) |
5.2请求参数
请求参数Body以multipart/form-data⽅式提交
| 参数名 | 是否必须 | 类型 | 说明 |
|---|---|---|---|
| appId | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| appKey | 是 | String | 请在https://www.chuanglan.com/登录后获取 |
| taskId | 是 | String | 任务id |
5.3响应内容
| 字段名 | 类型 | 说明 |
|---|---|---|
| chargeStatus | int | 是否收费,1:收费;0:不收费 |
| code | String | 响应code码。200000:成功,其他失败。 |
| message | String | 响应code码解释 |
| data | List | 多个敏感词组,每组表示闪测敏感词后短信内容可以满足触达率要求,有可返回空数组,表示该短信内容绝大部分 |
5.4 返回成功示例
{
"chargeStatus": 0,
"message": "请求成功",
"data": [
[
"⼀同",
"联名",
"抢",
"来",
"周边",
"等",
"奇幻",
"世界",
"戳"
],
[
"世界",
"联名"
]
],
"code": "200000"
}闪测2.0公共错误码
本⽂罗列并说明公共错误码。若想了解某个接⼝业务逻辑相关的错误码,请参考该接⼝的说明⽂档。
| 状态码 | 错误码 | 错误信息 | 说明 |
|---|---|---|---|
| 400 | 请求参数错误 | ||
| 401 | 请求Header错误 | ||
| 500 | 未知错误 | 服务出现故障 | |
| 200 | 100101 | 拆分号码库失败 | |
| 200 | 100102 | 号码库终端分布请求失败 | |
| 200 | 100103 | AIGC⽣成或优化内容失败 | |
| 200 | 100104 | 诊断记录创建失败 | |
| 200 | 100107 | ⽂件号码库不能为空 | |
| 200 | 100108 | loopCount⽣成短信时,最少检测优化1次 | |
| 200 | 100109 | 历史诊断检测任务不存在 | |
| 200 | 100110 | ⽆可下载的品牌分布数据 | |
| 200 | 100111 | 诊断记录创建失败 | |
| 200 | 100112 | 品牌分布格式错误,例如:"huawei":0.8,"other":0.2 |
异常返回⽰例:
{
"code": 100104,
"data": "",
"message": "诊断记录创建失败"
}这篇文档对您有帮助吗?




