縮短鏈接地址：可用于縮短鏈接場景的短地址短鏈接免費(fèi)接口

文章來源：本站原創(chuàng)　發(fā)布者：admin　發(fā)布時(shí)間：2021-05-01 17:14:39　瀏覽次數(shù)：0

短地址短鏈接接口服務(wù)，申請后即可免費(fèi)使用，提供全接口服務(wù)，縮短鏈接地址，廣泛應(yīng)用于縮短鏈接場景，如：電子發(fā)票鏈接，促銷活動(dòng)鏈接，新聞文章鏈接等。

使用說明：

1、以下短地址接口開發(fā)資料供開發(fā)技術(shù)人員參考
　　2、短地址接口開發(fā)技術(shù)支持請發(fā)郵件至：support@ebaitian.cn

一、協(xié)議說明：

協(xié)議	HTTP POST/GET
編碼格式	UTF8
URL	http://u10.ink/yun/json
參數(shù)	appid={appid}&module={module}&stamp={stamp}&sign={sign}&url={url}&notes={notes}&expire={expire}
使用場景	短地址注冊（縮短地址，將長地址縮短為短地址）
接口說明	短地址注冊時(shí)，服務(wù)器會(huì)自動(dòng)驗(yàn)證目標(biāo)鏈接的有效性（重定向鏈接不支持注冊）。備注：為了數(shù)據(jù)傳輸?shù)陌踩?，建議使用 HTTP POST 協(xié)議開發(fā)接入應(yīng)用。

二、參數(shù)說明：

公共參數(shù)：

appid	必須參數(shù)：授權(quán)接口的AppID（請?zhí)顚懩诠倬W(wǎng)上申請到的 AppID）
module	必須參數(shù)：請求模塊（短地址注冊賦值：addurl）
stamp	必須參數(shù)：請求時(shí)間戳（五分鐘內(nèi)有效）
sign	必須參數(shù)：簽名，即請求憑證（簽名校驗(yàn)，計(jì)算公式見下面的其他說明）

請求參數(shù)：

url	必須參數(shù)：目標(biāo)鏈接地址（要被縮短的原始鏈接地址，HTTP 狀態(tài)碼必須為 200）
notes	可選參數(shù)：短地址說明或備注
expire	可選參數(shù)：短地址的失效時(shí)間（必須為時(shí)間戳，否則傳入值無效）

其他說明：

1、sign 簽名根據(jù)公式 $sign=sha256(appid={appid}&url={url}&notes={notes}&expire={expice}&module=addurl&stamp={stamp}&appkey={appkey}) 生成；
　　2、簽名計(jì)算中：appkey 為授權(quán)接口的 AppKey，請?zhí)顚懩诠倬W(wǎng)上申請到的 AppKey ；
　　3、簽名計(jì)算注意：簽名字符串拼接時(shí)，除 appid 、appkey 外的字段使用字典順序排序拼接，appid 位于最開始，appkey 位于結(jié)尾，最終拼接完后進(jìn)行 sha256 的計(jì)算得到簽名值

請求示例：

1、數(shù)據(jù)包體：

{
　"appid": "100000xx",
　"module": "addurl",
　"stamp": "1618770583",
　"sign": "4059492c33a935de2a05c5a642b259cfcc5ae1540f312cb9bb42f21f5f706e02",
　"url": "http://jinantimes.com",
　"notes": "官方網(wǎng)站",
　"expice": "1618770583"
}

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

三、返回?cái)?shù)據(jù)包體：

JSON 數(shù)據(jù)

成功返回：

{
　"result": 1,
　"description": "TRUE",
　"flag": "地址注冊成功",
　"data": {
　　"short_url": "http://u10.ink/Iez6Ru",
　　"source_url": "http://jinantimes.com",
　　"notes": "官方網(wǎng)站",
　　"expire": 1621362982,
　　"datetime": 1618770982
　}
}

失敗返回：

{
　"result":0,
　"description":"FALSE",
　"flag":"目標(biāo)鏈接地址已存在"
}

參數(shù)說明：

result	0-失敗；1-成功
description	請求結(jié)果描述；成功返回 TRUE ，失敗返回 FALSE
flag	返回詳細(xì)信息
data	僅請求成功時(shí)才會(huì)返回此參數(shù) data 參數(shù)說明： short_url：注冊成功的短地址 source_url：目標(biāo)鏈接地址 notes：說明或備注 expire：短地址的失效時(shí)間 datetime：短地址的注冊時(shí)間