短网址API接口

生成接口

GET方式传入的网址需要进行urlencode编码,否则一些带特殊参数的网址无法完整记录!推荐使用POST方式提交。接口请勿滥用,对滥用者我们会限制其接入权限

接口参数 &userId=?&key=? 两个值可以在管理中心→网址列表中得到

TXT格式短网址API接口

例如:https://12i.cn/api.ashx?format=txt&userId=?&key=?&url=https://www.baidu.com

返回:https://12i.cn/baidu

JSON格式短网址API接口

说明:format为json

例如:https://12i.cn/api.ashx?format=json&userId=?&key=?&url=https://www.baidu.com

返回:{"url":"https://12i.cn/baidu"}

JSONP格式短网址API接口

说明:format为jsonp

例如:https://12i.cn/api.ashx?format=jsonp&userId=?&key=?&url= https://www.baidu.com&callback=callbackname

返回:callbackname({"url":"https://12i.cn/baidu"})

批量提交接口

说明:format为more 各个网址中间用\r\n隔开,返回的短网址用|分隔,顺序和传入网址一一对应,一次性最多提交50个网址

例如:https://12i.cn/api.ashx?format=more&userId=?&key=?&url=https://www.baidu.com\r\nhttps://code.csdn.net

返回:{"url":"https://12i.cn/baidu|https://12i.cn/csdn"}

查询接口

总PV、UV查询接口

说明:format为 visitor

例如:https://12i.cn/api.ashx?format=visitor&userId=?&key=?&url=https://12i.cn/xxxxxx

返回:{ "success": "ok", "pv": 22794, "uv": 19837 }

最近30天每日PV、UV、新访客信息(年付会员)

说明:format为 day

例如:https://12i.cn/api.ashx?format=day&userId=?&key=?&url=https://12i.cn/xxxxxx

返回:[{"id":1,"day":"2018-05-07","visitCount":5,"pc":5,"mobile":0,"uv":5,"newClinetCount":3},{"id":0,"day":"2018-05-08","visitCount":21,"pc":21,"mobile":0,"uv":21,"newClinetCount":16}]

删除接口

说明:format为 del

例如:https://12i.cn/api.ashx?format=del&userId=?&key=?&url=https://12i.cn/xxxxxx

返回:{ "success": "ok"}

短信一号一址(企业会员)

接口:https://12i.cn/api/apimessage.ashx

获取短网址

POST参数:format=add, userId=?,key=?,count=1(数量最多1万),title=?,url=https://www.baidu.com

返回:{ "success": "ok", "data": "Y0i1l,Y0i1m" } 每个短网址后缀用逗号分割,使用的时候请加上https://12i.cn/加后缀,如https://12i.cn/Y0i1l 若在后台设置自定义域名也可以使用自定义的域名

短网址有效期10天

根据标题获取点击过的短网址数量

POST参数:format=getCount, userId=?,key=?, title=?

返回:{ "success": "ok", "data": "4" }

根据标题获取点击过的短网址和设备信息

我们建议先查询点击过的短网址数量,然后使用skip,take分页返回数据以提高响应速度

POST参数:format=getFromTitle, title=?, userId=?,key=?,(skip=?整数,take=?整数 这两个参数为选填,必须成对出现,skip掠过多少条,take读取多少条) 注意参数大小写

返回:{ "success": "ok", "data": "[{"key":"YI6D0ac","value":"三星 S5"},{"key":"YI6D0ab","value":"三星 S5"},{"key":"YI6D0af","value":"iPhone"},{"key":"YI6D0ag","value":"iPhone"}]" }

返回值说明:key是短网址,value为访客用的设备

上传对应数据

为保护客户隐私,建议用户在本地匹配不上传

POST参数:format=update, userId=?,key=?,url=[{"key":"Y0i1m","value":"13075777777"},{"key":"Y0i1l","value":"13075777777"}] url是json字符串,key代表短网址后缀,value代表对应的手机号码(为保护隐私也可以上传数字代替手机号码)

返回:{"success": "ok","data": "2"} data代表成功个数