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"