缩短链接地址：可用于缩短链接场景的短地址短链接免费接口

文章来源：本站原创　发布者：admin　发布时间：2021-05-01 17:14:39　浏览次数：0

短地址短链接接口服务，申请后即可免费使用，提供全接口服务，缩短链接地址，广泛应用于缩短链接场景，如：电子发票链接，促销活动链接，新闻文章链接等。

使用说明：

1、以下短地址接口开发资料供开发技术人员参考
　　2、短地址接口开发技术支持请发邮件至：support@ebaitian.cn

一、协议说明：

协议	HTTP POST/GET
编码格式	UTF8
URL	http://u10.ink/yun/json
参数	appid={appid}&module={module}&stamp={stamp}&sign={sign}&url={url}&notes={notes}&expire={expire}
使用场景	短地址注册（缩短地址，将长地址缩短为短地址）
接口说明	短地址注册时，服务器会自动验证目标链接的有效性（重定向链接不支持注册）。备注：为了数据传输的安全，建议使用 HTTP POST 协议开发接入应用。

二、参数说明：

公共参数：

appid	必须参数：授权接口的AppID（请填写您在官网上申请到的 AppID）
module	必须参数：请求模块（短地址注册赋值：addurl）
stamp	必须参数：请求时间戳（五分钟内有效）
sign	必须参数：签名，即请求凭证（签名校验，计算公式见下面的其他说明）

请求参数：

url	必须参数：目标链接地址（要被缩短的原始链接地址，HTTP 状态码必须为 200）
notes	可选参数：短地址说明或备注
expire	可选参数：短地址的失效时间（必须为时间戳，否则传入值无效）

其他说明：

1、sign 签名根据公式 $sign=sha256(appid={appid}&url={url}&notes={notes}&expire={expice}&module=addurl&stamp={stamp}&appkey={appkey}) 生成；
　　2、签名计算中：appkey 为授权接口的 AppKey，请填写您在官网上申请到的 AppKey ；
　　3、签名计算注意：签名字符串拼接时，除 appid 、appkey 外的字段使用字典顺序排序拼接，appid 位于最开始，appkey 位于结尾，最终拼接完后进行 sha256 的计算得到签名值

请求示例：

1、数据包体：

{
　"appid": "100000xx",
　"module": "addurl",
　"stamp": "1618770583",
　"sign": "4059492c33a935de2a05c5a642b259cfcc5ae1540f312cb9bb42f21f5f706e02",
　"url": "https://www.ebaitian.cn",
　"notes": "官方网站",
　"expice": "1618770583"
}

　　2、请求地址：http://u10.ink/yun/json

三、返回数据包体：

JSON 数据

成功返回：

{
　"result": 1,
　"description": "TRUE",
　"flag": "地址注册成功",
　"data": {
　　"short_url": "http://u10.ink/Iez6Ru",
　　"source_url": "https://www.ebaitian.cn",
　　"notes": "官方网站",
　　"expire": 1621362982,
　　"datetime": 1618770982
　}
}

失败返回：

{
　"result":0,
　"description":"FALSE",
　"flag":"目标链接地址已存在"
}

参数说明：

result	0-失败；1-成功
description	请求结果描述；成功返回 TRUE ，失败返回 FALSE
flag	返回详细信息
data	仅请求成功时才会返回此参数 data 参数说明： short_url：注册成功的短地址 source_url：目标链接地址 notes：说明或备注 expire：短地址的失效时间 datetime：短地址的注册时间