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

热门搜索

中国

中国站

创蓝云智

国际站

Innopaas

API文档

更新时间：2026-07-30 18:28:13

日期版本修订内容摘要
2023-08-18v2.0.0更新接口文档

接口说明

API接口适用于不通过创蓝渠道发送短信客户，或者有特殊定制服务的客户。

API接口调用属于收费项目，具体收费详情请联系相关客户经理。

深链针对客户提供API创建接口

（1）支持短链链接，创建1号1链

（2）支持通知短信，长链转短链服务

（3）创建的短链可用于任意检测服务，如：微博、微信、公众号、网站等

（4）获取AppId和AppKey

深链API接口计费服务

API接口采用会员制模式，开通短链会员即可调用API。

创建一号一链（一号一链有效期为30天，无数量限制）

一号一链

接口地址 https://slapi.chuanglan.com/prod/url/trace

请求方式 POST

consumes ["application/json"]

produces ["/"]

接口描述 30天有效期，不支持点击数据统计

HEAD请求参数

参数名称参数说明请求类型是否必须数据类型
aid智能短链平台API页面的APPIDheadtruestring
sign sign=MD5.getMd5(aid + appKey + body + timestamp)

aid：深链API页面的APPID
appKey：深链API页面的appKey
body：请求的数据包JSON
timestamp：时间戳 		headtruestring
timestamp时间戳headtruestring
Content-Type application/json

签名生成示例

Map<String, Object> parammap = new HashMap<>();
parammap.put("url","a3xx.cc/v-UMxxU");
parammap.put("phone","15673494722");
parammap.put("batch","00999999999999991");
String s = JSONUtil.toJsonStr(parammap);
String checkSign = DigestUtil.md5Hex("65939497874632704" +
        "c1694936e58549b1bf8c8da36637b89f" + s + "1671096829626");
![](https://static2.253.com/document/2023-07/4X8JQAJUQXIEAL9F.png)

Body请求参数

参数名称参数说明请求类型是否必须数据类型
batch批次号bodytruestring
phone手机号码（多个号码以逗号间隔）bodytruestring
urlurlbodytruestring
domain自定义域名bodyfalse

请求示例

{
    "endDate":"2022-07-29",
    "shortUrl":"52.cn/v-6kp44",
    "startDate":"2022-07-28",
    "status":"0"
}

响应参数

参数名称参数说明类型schema
code状态码string
data返回数据object
message描述信息string
success是否成功boolean

响应示例

{
    "code": "",
    "data": {},
    "message": "",
    "success": true
}

响应状态

状态码说明描述
200OKAPI响应结果«Map«string,string»»
201Created创建成功
401Unauthorized验证错误
403Forbidden禁止创建
404Not Found未找到

单条长链接转短链接

接口地址 https://slapi.chuanglan.com/prod/url/short

请求方式 POST

consumes ["application/x-www-form-urlencoded"]

produces ["/"]

接口描述 30天有效期，不支持点击数据统计

HEAD请求参数

参数名称参数说明请求类型是否必须数据类型
aid智能短链平台API页面的APPIDheadtruestring
sign sign=MD5.getMd5(aid + appKey + body + timestamp)

aid：深链API页面的APPID
appKey：深链API页面的appKey
body：请求的数据包JSON
timestamp：时间戳 		headtruestring
timestamp时间戳headtruestring
Content-Type application/x-www-form-urlencoded

请求头示例

Query参数

参数名称参数说明请求类型是否必须数据类型
urlurlquerytruestring
domain自定义域名queryfalsestring

请求体示例

响应参数

参数名称参数说明类型schema
code状态码string
data返回数据object
message描述信息string
success是否成功boolean

响应示例

{
  "success": true,
  "code": "000000",
  "message": "成功",
  "data": {
    "shortUrl": "http://172.16.41.121:8082/sbQaQrm"
  }
}

响应状态

状态码说明描述
200OKAPI响应结果«Map«string,string»»
201Created创建成功
401Unauthorized验证错误
403Forbidden禁止创建
404Not Found未找到

注意：postman调用时，会将oldUrl中的/转义成%2F，代码中调用无需转义

生成签名sign示例

String data = "url=http://baidu.com&domain=a3h.cc";
String checkSign = MD5.getMd5("123123123123" +
        "c1694936e58549b1bf8c8da388888888" + data + "1671096829626");

# 批量长链接转短链接

**接口地址** https://slapi.chuanglan.com/prod/url/batch_short
  
**请求方式** POST
  
**consumes** ["application/json"]

**produces** ["*/*"]

**接口描述** 30天有效期，一次请求最多传入100个长链，长链与短链顺序对应，不支持点击数据统计

## HEAD请求参数

| **参数名称** | **参数说明**                                                 | **请求类型** | **是否必须** | **数据类型** |
| ------------ | ------------------------------------------------------------ | ------------ | ------------ | ------------ |
| aid          | 智能短链平台API页面的APPID                                   | head         | true         | string       |
| sign         | sign= MD5.getMd5(aid + appKey + body + timestamp)<br />aid：深链API页面的APPID<br />appKey：深链API页面的appKey<br />body：请求的数据包JSON  <br />timestamp： 时间戳 | head         | true         | string       |
| timestamp    | 时间戳                                                       | head         | true         | string       |
| Content-Type | [application/json](https://blog.csdn.net/qq_14869093/article/details/86307084#applicationjson_42) |              |              |              |

## Body请求参数

| **参数名称** | **参数说明**           | **请求类型** | **是否必须** | **数据类型** |
| ------------ | ---------------------- | ------------ | ------------ | ------------ |
| batchId      | 批次号                 | body         | false        | string       |
| urlsdomain   | 链接地址数组自定义域名 | bodyquery    | truefalse    | arraystring  |
| domain       | 自定义域名             | body         | false        | string       |

**请求示例**

```java
{
    "batchId": "",
    "domain": "",
    "urls": ["www.baidu.com", "www.baidu2.com"]
}

响应参数

参数名称参数说明类型schema
code状态码string
datadata返回数据返回数据
shortUrl短链接 描述信息array
message描述信息是否成功string
success是否成功boolean

响应示例

{
    "success": true,
    "code": "000000",
    "message": "成功",
    "data": {
      "shortUrl": [
            "172.16.41.121:8082/JmGincJ",
            "172.16.41.121:8082/JmHImR2",
            "172.16.41.121:8082/JmHImR3",
            "172.16.41.121:8082/JmHZXZ6",
            "172.16.41.121:8082/JmHZXZ7",
            "172.16.41.121:8082/JmHZXZ8"
        ]
            }
    ]
}

响应状态

状态码说明描述
200OKAPI响应结果«Map«string,string»»
201Created创建成功
401Unauthorized验证错误
403Forbidden禁止创建
404Not Found未找到

创建追踪短链/深链

接口地址 https://slapi.chuanglan.com/prod/url/short_trace

请求方式 POST

consumes ["application/json"]

produces ["/"]

接口描述 带v-的母链，有数量限制，永久100条，临时5000条/天，建议尽量使用临时的追踪短链

HEAD请求参数

参数名称参数说明请求类型是否必须数据类型
aid智能短链平台API页面的APPIDheadtruestring
sign sign=MD5.getMd5(aid + appKey + body + timestamp)

aid：深链API页面的APPID
appKey：深链API页面的appKey
body：请求的数据包JSON
timestamp：时间戳 		headtruestring
timestamp时间戳headtruestring
Content-Type application/json

Body请求参数

参数名称参数说明请求类型是否必须数据类型
name短链名称bodytruestring
url跳转链接bodytruestring
domain自定义域名bodyfalsestring
miniPath路径或商品编号bodyfalsestring
type功能类型：0 普通短链；1 小程序；2 小商店；3 APPbodytrueinteger
miniAppId小程序的APPIDbodytype为1和2的时候必填string
expiredType过期类型：0 永久；1 自定义bodyfalse（默认0）integer
expiredTime过期时间bodytype为1时必填（示例：2023-01-03）string
iosUrl如果为小程序、小商店、APP未安装时，iOS默认跳转地址bodyfalsestring
androidUrl如果为小程序、小商店、APP未安装时，Android默认跳转地址bodyfalsestring
tlDeeplinkChannelConfigList渠道配置bodyfalsearray
↳ url跳转链接bodytruestring
↳ area区域：省bodyfalse（不填为不限）array(int)
↳ sysOS操作系统：WINDOS、IOS、Andriod等bodyfalse（不填为不限）array(int)
↳ accessSource访问来源：微信、QQ等bodyfalseinteger
↳ status0：关闭；1：开启body默认1：开启integer
↳ proportion占比bodyskipType为2时必填integer（1-100）
skipType渠道跳转方式：1 正常跳；2 比例跳；3 随机跳bodyfalseinteger
preventBlock防封锁：0 关闭；1 开启bodyfalse，默认关闭integer

请求示例

{
        "iosUrl": "https://www.baidu.com",
        "androidUrl": "https://www.baidu.com",
        "domain": "agxx.cn",
        "expiredType": 0,
        "miniAppId": "wx06582xxxf92db5ad",
        "name": "测试创建",
        "preventBlock": 0,
        "skipType": 1,
        "tlDeeplinkChannelConfigList": [
                {
                        "accessSource": 0,
                        "area": [1,2,3],
                        "status": 1,
                        "sysOS": [2],
                        "url": "http://www.taobao.com"
                },
                {
                        "accessSource": 0,
                        "area": [1,2,3],
                        "status": 1,
                        "sysOS": [2],
                        "url": "http://www.taobao.com"
                }
        ],
        "type": 1,
        "url": "http://www.tieba.com"
}

area数据

IDareaIDareaIDarea
1北京2天津3河北
4山西5内蒙古6辽宁
7吉林8黑龙江9上海
10江苏11浙江12安徽
13福建14江西15山东
16河南17湖北18湖南
19广东20广西21海南
22重庆23四川24贵州
25云南26西藏27陕西
28甘肃29青海30宁夏
31新疆32香港33澳门
34台湾

sysOS数据

IDsystemIDsystemIDsystem
1安卓2iPhone3Mac
4Mac5鸿蒙

accessSource数据

IDresourceIDresourceIDresourceIDresource
0不限3QQ4微信-1其他

响应参数

参数名称参数说明类型schema
code状态码string
data返回数据
idstring
url短链接string
message描述信息string
success是否成功boolean

响应示例

{
  "success": true,
  "message": "创建成功",
  "code": "000000",
  "data": {
    "id": "15840687811211264",
    "url": "aglc.cn/v-TOzZK"
  }
}

响应状态

状态码说明描述
200OKAPI响应结果«Map«string,string»»
201Created创建成功
401Unauthorized验证错误
403Forbidden禁止创建
404Not Found未找到
000800永久短链超过100条
000801当天临时短链创建超过5000条
000900未初始化客户信息

数据统计

访问曲线

接口地址 https://slapi.chuanglan.com/dplink/queryAccessCurve

请求方式 POST

consumes ["application/json"]

produces ["/"]

接口描述 ``

HEAD请求参数

参数名称参数说明请求类型是否必须数据类型
aid智能短链平台API页面的APPIDheadtruestring
sign sign=MD5.getMd5(aid + appKey + body + timestamp)

aid：深链API页面的APPID
appKey：深链API页面的appKey
body：请求的数据包JSON
timestamp：时间戳 		headtruestring
timestamp时间戳headtruestring

Body请求参数

参数名称参数说明请求类型是否必须数据类型
endDate结束时间批次号bodyfalsestring
shortUrl链接地址bodytruestring
startDate开始时间自定义域名bodyfalsestring
status0：仅有效访问bodyfalsestring

请求示例

{
    "endDate":"2022-07-29",
    "shortUrl":"52.cn/v-6kp44",
    "startDate":"2022-07-28",
    "status":"0"
}

响应参数

参数名称参数说明类型schema
codestring
data访问总曲线访问总曲线
accessCurveVoList访问量明细array访问曲线
  browseCountVo访问量访问量访问量
  clickCount访问点击量integer
  ipCount访问IP数integer
  phoneCount访问手机数integer
  uvCountuvinteger
date访问日期string
totalList总访问量array访问总量
  name访问名称string
  value总访问量integer
messagestring
successboolean

响应示例

    "success":true,
    "message":"请求成功",
    "code":"000000",
    "data":{
        "totalList":[
            {
                "name":"访问量",
                "value":0
            },
            {
                "name":"访问手机数",
                "value":0
            },
            {
                "name":"访问ip数",
                "value":0
            },
            {
                "name":"访问uv数",
                "value":0
            }
        ],
        "accessCurveVoList":[
            {
                "date":"28日",
                "browseCountVo":{
                    "clickCount":0,
                    "phoneCount":0,
                    "ipCount":0,
                    "uvCount":0
                }
            },
            {
                "date":"29日",
                "browseCountVo":{
                    "clickCount":0,
                    "phoneCount":0,
                    "ipCount":0,
                    "uvCount":0
                }
            }
        ]
    }
}

响应状态

状态码说明描述
200OKAPI响应结果«Map«string,string»»
201Created创建成功
401Unauthorized验证错误
403Forbidden禁止创建
404Not Found未找到

归属地

接口地址 https://slapi.chuanglan.com/dplink/queryIpAddress

请求方式 POST

consumes ["application/json"]

produces ["/"]

接口描述 ``

HEAD请求参数

参数名称参数说明请求类型是否必须数据类型
aid智能短链平台API页面的APPIDheadtruestring
sign sign=MD5.getMd5(aid + appKey + body + timestamp)

aid：深链API页面的APPID
appKey：深链API页面的appKey
body：请求的数据包JSON
timestamp：时间戳 		headtruestring
timestamp时间戳headtruestring

Body请求参数

参数名称参数说明请求类型是否必须数据类型
endDate结束时间批次号bodyfalsestring
shortUrl链接地址bodytruestring
startDate开始时间自定义域名bodyfalsestring
status0：仅有效访问bodyfalsestring

请求示例

{
    "endDate":"2022-07-29",
    "shortUrl":"52.cn/v-6kp44",
    "startDate":"2022-07-28",
    "status":"0"
}

响应参数

参数名称参数说明类型schema
codestring
dataarrayIP归属地
  area区string
  city市string
  count数量integer
  percentage百分比string
  province省string
  totalCount数量integer
messagestring
successboolean

响应示例

{
    "success":true,
    "message":"请求成功",
    "code":"000000",
    "data":[
        {
            "province":"上海市",
            "city":null,
            "area":null,
            "percentage":"0.00%",
            "count":0,
            "totalCount":null
        },
        {
            "province":"云南省",
            "city":null,
            "area":null,
            "percentage":"0.00%",
            "count":0,
            "totalCount":null
        }
    ]
}

响应状态

状态码说明描述
200OKAPI响应结果«Map«string,string»»
201Created创建成功
401Unauthorized验证错误
403Forbidden禁止创建
404Not Found未找到

操作系统

接口地址 https://slapi.chuanglan.com/dplink/queryOperatingSystem

请求方式 POST

consumes ["application/json"]

produces ["/"]

接口描述 ``

HEAD请求参数

参数名称参数说明请求类型是否必须数据类型
aid智能短链平台API页面的APPIDheadtruestring
sign sign=MD5.getMd5(aid + appKey + body + timestamp)

aid：深链API页面的APPID
appKey：深链API页面的appKey
body：请求的数据包JSON
timestamp：时间戳 		headtruestring
timestamp时间戳headtruestring

Body请求参数

参数名称参数说明请求类型是否必须数据类型
endDate结束时间批次号bodyfalsestring
shortUrl链接地址bodytruestring
startDate开始时间自定义域名bodyfalsestring
status0：仅有效访问bodyfalsestring

请求示例

{
    "endDate":"2022-07-29",
    "shortUrl":"52.cn/v-6kp44",
    "startDate":"2022-07-28",
    "status":"0"
}

响应参数

参数名称参数说明类型schema
codestring
dataarray操作系统
  count数量integer
  logologo图标string
  percentage百分比string
  systemName系统名称string
  totalCount总量integer
messagestring
successboolean

响应示例

{
    "success":true,
    "message":"请求成功",
    "code":"000000",
    "data":[
        {
            "logo":null,
            "systemName":"Android",
            "percentage":"0.00%",
            "count":0,
            "totalCount":0
        },
        {
            "logo":null,
            "systemName":"MacOS",
            "percentage":"0.00%",
            "count":0,
            "totalCount":0
        },
        {
            "logo":null,
            "systemName":"Windows",
            "percentage":"0.00%",
            "count":0,
            "totalCount":0
        },
        {
            "logo":null,
            "systemName":"iOS",
            "percentage":"0.00%",
            "count":0,
            "totalCount":0
        },
        {
            "logo":null,
            "systemName":"other",
            "percentage":"0.00%",
            "count":0,
            "totalCount":0
        }
    ]
}

响应状态

状态码说明描述
200OKAPI响应结果«Map«string,string»»
201Created创建成功
401Unauthorized验证错误
403Forbidden禁止创建
404Not Found未找到

浏览器

接口地址 https://slapi.chuanglan.com/dplink/queryBrowser

请求方式 POST

consumes ["application/json"]

produces ["/"]

接口描述 ``

HEAD请求参数

参数名称参数说明请求类型是否必须数据类型
aid智能短链平台API页面的APPIDheadtruestring
sign sign=MD5.getMd5(aid + appKey + body + timestamp)

aid：深链API页面的APPID
appKey：深链API页面的appKey
body：请求的数据包JSON
timestamp：时间戳 		headtruestring
timestamp时间戳headtruestring

Body请求参数

参数名称参数说明请求类型是否必须数据类型
endDate结束时间批次号bodyfalsestring
shortUrl链接地址bodytruestring
startDate开始时间自定义域名bodyfalsestring
status0：仅有效访问bodyfalsestring

请求示例

{
    "endDate":"2022-07-29",
    "shortUrl":"52.cn/v-6kp44",
    "startDate":"2022-07-28",
    "status":"0"
}

响应参数

参数名称参数说明类型schema
codestring
dataarray浏览器
  count数量integer
  logologo图标string
  percentage百分比string
  systemName浏览器名称string
  totalCount数量integer
messagestring
successboolean

响应示例

{
    "success":true,
    "message":"请求成功",
    "code":"000000",
    "data":[
        {
            "logo":null,
            "systemName":"Chrome",
            "percentage":"0.00%",
            "count":0,
            "totalCount":0
        },
        {
            "logo":null,
            "systemName":"Firefox",
            "percentage":"0.00%",
            "count":0,
            "totalCount":0
        },
        {
            "logo":null,
            "systemName":"QQ浏览器",
            "percentage":"0.00%",
            "count":0,
            "totalCount":0
        },
        {    
            "logo":null,
            "systemName":"ie浏览器",
            "percentage":"0.00%",
            "count":0,
            "totalCount":0
        },
        {
            "logo":null,
            "systemName":"uc浏览器",
            "percentage":"0.00%",
            "count":0,
            "totalCount":0
        },
        {
            "logo":null,
            "systemName":"百度浏览器",
            "percentage":"0.00%",
            "count":0,
            "totalCount":0
        }
    ]
}

响应状态

状态码说明描述
200OKAPI响应结果«Map«string,string»»
201Created创建成功
401Unauthorized验证错误
403Forbidden禁止创建
404Not Found未找到

运营商

24小时热线 400-9669-253
产品推荐
验证码短信
通知短信
国际验证码短信
视频短信
5G融合消息
行为验证码
其他产品
国内语音消息
活体检测SDK
短信LOGO认证
解决方案
注册登录
新客获客
老客激活
电商行业
游戏行业
餐饮行业
关于我们
关于我们
智慧党建
常见问题
开发者中心
创蓝社区
logo

公司地址：上海市松江区广富林东路199号4栋9楼

24小时热线：400-9669-253
微信

创蓝公众号

企业微信

联系商务

上海创蓝云智信息科技股份有限公司版权所有Copyright © 2026 ALL RIGHTS RESERVED
增值电信业务经营许可证：B2-20144076沪ICP备案：15046301号-2 15046301号-16创蓝云智沪公网安备案 31011702001190号/31011702008034号创蓝云智