CN短网址开放接口文档-预览版

CN 短网址开放接口文档 ,1 总体说明1.1 概述CN 短网址平台,是一套自主研发的,旨在为从事网络营销团队服务的专业的网址缩短系统,它提供丰富的接口及平台,多种接入方式

CN 短网址开放接口文档

,

1 总体说明

1.1 概述

CN 短网址平台,是一套自主研发的,旨在为从事网络营销团队服务的专业的网址缩短系统,它提供丰富的接口及平台,多种接入方式,为广大网销团队提供快捷,安全,透明,准确的网址缩短以及转发服务。

该文档面向淘宝客人员、开发人员,网络推广人员,网赚人员,介绍CN 短网址平台对任意平台的接口规范,即您的业务(或网站)如何接入CN 短网址平台,获得网址缩短以及转发服务。为了方便您的业务接入CN 短网址平台,CN 短网址平台提供了如下API 供您的业务或平台网站使用。使用接口之前,您的业务或平台网站需要向CN 短网址注册,获得CN 短网址平台提供的您的业务或平台网站的接入 appid和相应的secret 信息。

1.2 接入准备

您需要通过注册用户,注册成功后,您将会从CN 短网址平台获得 appid和相应的secret 信息。

CN 短网址平台网址是http://www.cndwz.com

2 详细说明

API 所有参数均是UTF-8编码

API 严格遵循REST 协议规范

2.1 API 系统参数(每个API 接口都必须包含的参数信息)

API 请求参数为JSON 格式,通过HTTP 请求 GET/POST/PUT/DELETE 发送,必须将Content-type 设置为:application/json。参数分为两种:系统参数和业务参数,系统参数每个API 请求都必须携带;业务参数将分别说明。以下是系统参数:

,

业务参数将在下面的每个接口分别进行说明,系统参数和业务参数组成的对象对应的JSON ,作为请求的参数。

API 以JSON 格式返回信息,返回信息是由以下参数组成的对象组成的JSON 数据:

3 API 接口详细说明

3.1 短网址添加API

3.1.1 API 接口说明

通过本接口,您可以将您的网址转换成短网址,并可以设置附加的设置项,这些网址在添加后您可以通过网站后台和接口进行获取或管理,后面会有获取和修改以及删除的详细API 。

3.1.2 API 接口地址

提交方式(method):GET and POST

,

GET 提交必填信息,如,appkey 、secret 、长网址数据 POST 提交选填信息

3.1.3 系统参数

3.1.4 业务数据

例如:

请求地址:http://api.cndwz.com/post/您的appkey/您的secret/需要转换的网址(base64编码格式) POST 传参(JSON): {

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

"desc": "这里是短网址描述", "funcur": "8888", "timeslimit": "1000", "password": "1234", "starttime": "1422195396", "endtime": "1422199999", "name": "这里是短网址标题" }

返回信息:

,

成功,返回状态、状态码、信息、短网址在数据库中的编号、短网址、短网址对应的二维码地址,可以直接在img 标签引用该地址,如:

,

PUT 提交需要修改的信息

3.2.3 系统参数

3.2.4 业务数据

例如:

请求地址:http://api.cndwz.com/get/您的appkey/您的secret PUT 传参(JSON): [

{

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

"name": "这里是短网址标题", "status": "-2", "timeslimit": "100", "starttime": "1422195396", "endtime": "1422199999", "password": "1234",

"baseurl": "aHR0cDovL3d3dy5iYWlkdS5jb20vaW5kZXgucGhwP3RuPW1vbmxpbmVfNV9kZw==", "desc": "描述内容" }, {

"id": "624",

,

"type": "2",

"name": "短网址的标题也2",

"status": "-2",

"timeslimit": "100",

"starttime": "0",

"endtime": "0",

"password": "11233",

"baseurl": "aHR0cDovL3d3dy5iYWlkdS5jb20vaW5kZXgucGhwP3RuPW1vbmxpbmVfNV9kZw==", "desc": "描述内容"

}

]

返回信息:

{

"success": [

"623",

"624"

,

3.3 短网址删除API 3.3.1 API 接口说明

通过本接口,您可以根据短网址id 删除对应的短网址

3.3.2

API 接口地址

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

GET 提交需要获取短网址的ID(多个id 用逗号隔开后用base64加密)

3.3.3 系统参数

3.3.4 业务数据

例如:

请求地址: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"

标签: