CN 短網(wǎng)址開放接口文檔 ,1 總體說明1.1 概述CN 短網(wǎng)址平臺，是一套自主研發(fā)的，旨在為從事網(wǎng)絡(luò)營銷團(tuán)隊服務(wù)的專業(yè)的網(wǎng)址縮短系統(tǒng)，它提供豐富的接口及平臺，多種接入方式

CN 短網(wǎng)址開放接口文檔

1 總體說明

1.1 概述

CN 短網(wǎng)址平臺，是一套自主研發(fā)的，旨在為從事網(wǎng)絡(luò)營銷團(tuán)隊服務(wù)的專業(yè)的網(wǎng)址縮短系統(tǒng)，它提供豐富的接口及平臺，多種接入方式，為廣大網(wǎng)銷團(tuán)隊提供快捷，安全，透明，準(zhǔn)確的網(wǎng)址縮短以及轉(zhuǎn)發(fā)服務(wù)。

該文檔面向淘寶客人員、開發(fā)人員，網(wǎng)絡(luò)推廣人員，網(wǎng)賺人員，介紹CN 短網(wǎng)址平臺對任意平臺的接口規(guī)范，即您的業(yè)務(wù)（或網(wǎng)站）如何接入CN 短網(wǎng)址平臺，獲得網(wǎng)址縮短以及轉(zhuǎn)發(fā)服務(wù)。為了方便您的業(yè)務(wù)接入CN 短網(wǎng)址平臺，CN 短網(wǎng)址平臺提供了如下API 供您的業(yè)務(wù)或平臺網(wǎng)站使用。使用接口之前，您的業(yè)務(wù)或平臺網(wǎng)站需要向CN 短網(wǎng)址注冊，獲得CN 短網(wǎng)址平臺提供的您的業(yè)務(wù)或平臺網(wǎng)站的接入 appid和相應(yīng)的secret 信息。

1.2 接入準(zhǔn)備

您需要通過注冊用戶，注冊成功后，您將會從CN 短網(wǎng)址平臺獲得 appid和相應(yīng)的secret 信息。

CN 短網(wǎng)址平臺網(wǎng)址是http://www.cndwz.com

2 詳細(xì)說明

API 所有參數(shù)均是UTF-8編碼

API 嚴(yán)格遵循REST 協(xié)議規(guī)范

2.1 API 系統(tǒng)參數(shù)（每個API 接口都必須包含的參數(shù)信息）

API 請求參數(shù)為JSON 格式，通過HTTP 請求 GET/POST/PUT/DELETE 發(fā)送，必須將Content-type 設(shè)置為：application/json。參數(shù)分為兩種：系統(tǒng)參數(shù)和業(yè)務(wù)參數(shù)，系統(tǒng)參數(shù)每個API 請求都必須攜帶；業(yè)務(wù)參數(shù)將分別說明。以下是系統(tǒng)參數(shù)：

業(yè)務(wù)參數(shù)將在下面的每個接口分別進(jìn)行說明，系統(tǒng)參數(shù)和業(yè)務(wù)參數(shù)組成的對象對應(yīng)的JSON ，作為請求的參數(shù)。

API 以JSON 格式返回信息，返回信息是由以下參數(shù)組成的對象組成的JSON 數(shù)據(jù)：

3 API 接口詳細(xì)說明

3.1 短網(wǎng)址添加API

3.1.1 API 接口說明

通過本接口，您可以將您的網(wǎng)址轉(zhuǎn)換成短網(wǎng)址，并可以設(shè)置附加的設(shè)置項，這些網(wǎng)址在添加后您可以通過網(wǎng)站后臺和接口進(jìn)行獲取或管理，后面會有獲取和修改以及刪除的詳細(xì)API 。

3.1.2 API 接口地址

提交方式(method)：GET and POST

GET 提交必填信息，如，appkey 、secret 、長網(wǎng)址數(shù)據(jù) POST 提交選填信息

3.1.3 系統(tǒng)參數(shù)

3.1.4 業(yè)務(wù)數(shù)據(jù)

例如：

請求地址：http://api.cndwz.com/post/您的appkey/您的secret/需要轉(zhuǎn)換的網(wǎng)址(base64編碼格式) POST 傳參(JSON)： {

"type": "1", "domainid": "1",

"desc": "這里是短網(wǎng)址描述", "funcur": "8888", "timeslimit": "1000", "password": "1234", "starttime": "1422195396", "endtime": "1422199999", "name": "這里是短網(wǎng)址標(biāo)題" }

返回信息：

成功，返回狀態(tài)、狀態(tài)碼、信息、短網(wǎng)址在數(shù)據(jù)庫中的編號、短網(wǎng)址、短網(wǎng)址對應(yīng)的二維碼地址，可以直接在img 標(biāo)簽引用該地址，如:

PUT 提交需要修改的信息

3.2.3 系統(tǒng)參數(shù)

3.2.4 業(yè)務(wù)數(shù)據(jù)

例如：

請求地址：http://api.cndwz.com/get/您的appkey/您的secret PUT 傳參(JSON)： [

{

"id": "623", "type": "1",

"name": "這里是短網(wǎng)址標(biāo)題", "status": "-2", "timeslimit": "100", "starttime": "1422195396", "endtime": "1422199999", "password": "1234",

"baseurl": "aHR0cDovL3d3dy5iYWlkdS5jb20vaW5kZXgucGhwP3RuPW1vbmxpbmVfNV9kZw==", "desc": "描述內(nèi)容" }, {

"id": "624",

"type": "2",

"name": "短網(wǎng)址的標(biāo)題也2",

"status": "-2",

"timeslimit": "100",

"starttime": "0",

"endtime": "0",

"password": "11233",

"baseurl": "aHR0cDovL3d3dy5iYWlkdS5jb20vaW5kZXgucGhwP3RuPW1vbmxpbmVfNV9kZw==", "desc": "描述內(nèi)容"

}

]

返回信息：

{

"success": [

"623",

"624"

3.3 短網(wǎng)址刪除API 3.3.1 API 接口說明

通過本接口，您可以根據(jù)短網(wǎng)址id 刪除對應(yīng)的短網(wǎng)址

3.3.2

API 接口地址

GET 提交必填信息，如，appkey 、secret

GET 提交需要獲取短網(wǎng)址的ID(多個id 用逗號隔開后用base64加密)

3.3.3 系統(tǒng)參數(shù)

3.3.4 業(yè)務(wù)數(shù)據(jù)

例如：

請求地址：http://api.cndwz.com/delete/您的appkey/您的secret /id字符串

返回信息：

{

"status": "1",

"code": "1",

例如：

請求地址：http://api.cndwz.com/put/您的appkey/您的secret /id字符串

返回信息：

{

"status": "1",

"code": "2",

"success": [

"623"