API文档 - Tax短网址
短网址生成接口
接口地址:http://dwz.tax/api/create | |||
---|---|---|---|
返回格式:json/text/jsonp | |||
请求方式:get/post | |||
请求示例:http://dwz.tax/api/create?format=json&token=注册后获取&longurl=http://www.baidu.com | |||
请求参数(Body) | |||
字段 | 类型 | 必须 | 说明 |
format | string | 否 | 调用格式,值为json/text/jsonp或不传,不传时返回数据为json |
token | string | 必须 | 由数字和字母组成的32位字符 |
longurl | string | 必须 | 要缩短的长网址 |
rand | string | 否 | 随机生成,请输入要选择的种类 QQ:qq;微信:vx;抖音:dy;通用:ty; |
domain | string | 否 | 指定生成,请输入要使用的域名! |
alias | string | 否 | 自定义别名必须包含~!@#$%^&*()_=其中一个,留空为不限制 |
password | string | 否 | 设置访问密码,留空为不限制 |
expiry | datetime | 否 | 设置到期时间,格式为2020-02-02 02:02:02,留空为不限制 |
返回参数(Body) | |||
---|---|---|---|
字段 | 类型 | 说明 | |
code | string | 处理结果:'1'代表成功 | |
msg | string | 返回描述 | |
short | string | 生成的短链接,如果生成失败,则返回空 | |
date | datetime | 生成的短链接的时间 |
JSON接口返回文本
{
"code": 1,
"type": "url",
"longurl": "http://www.baidu.com",
"short": "http://dwz.tax/1f",
"date": "2021-06-18 16:33:38"
}
短网址还原接口
接口地址:http://dwz.tax/api/query | |||
---|---|---|---|
返回格式:json/text/jsonp | |||
请求方式:get/post | |||
请求示例:http://dwz.tax/api/query?format=json&dwz=http://dwz.tax/d | |||
请求参数(Body) | |||
字段 | 类型 | 必须 | 说明 |
format | string | 否 | 调用格式,值为json/text/jsonp或不传,不传时返回数据为json |
dwz | string | 必须 | 要查询的短网址 |
返回参数(Body) | |||
---|---|---|---|
字段 | 类型 | 说明 | |
code | string | 处理结果:'1'代表成功 | |
msg | string | 返回描述 | |
longurl | string | 查询到的原始地址 | |
short | string | 查询到的短链接 |
JSON接口返回文本
{
"code": 1,
"longurl": "http://www.baidu.com",
"short": "http://dwz.tax//1f",
}
短网址还原接口
接口地址:http://dwz.tax/api/revise | |||
---|---|---|---|
返回格式:json/text/jsonp | |||
请求方式:get/post | |||
请求示例:http://dwz.tax/api/revise?format=json&token=注册后获取&dwz=http://dwz.tax/d&longurl=http://check.uomg.com/ | |||
请求参数(Body) | |||
字段 | 类型 | 必须 | 说明 |
format | string | 否 | 调用格式,值为json/text/jsonp或不传,不传时返回数据为json |
token | string | 必须 | 由数字和字母组成的32位字符 |
dwz | string | 必须 | 待修改的短网址 |
longurl | string | 必须 | 修改后的短网址 |
返回参数(Body) | |||
---|---|---|---|
字段 | 类型 | 说明 | |
code | string | 处理结果:'200'代表成功 | |
msg | string | 返回描述 |
JSON接口返回文本
{
"code":200,
"msg":"成功修改0条"
}
对接示例代码
<?php $geturl = 'http://dwz.tax/api/create'; $param = http_build_query([ 'token' => '你的Token' ,'longurl' => '你的长网址' ,'format' => 'text' ]); $opts = [ 'http' => array( 'method' => "POST", 'header' => "Content-type: application/x-www-form-urlencoded\r\n". "Content-length:".strlen($param)."\r\n" . "Cookie: foo=bar\r\n" . "\r\n", 'content' => $param, ), "ssl" => array( "verify_peer" => false, "verify_peer_name" => false, ) ]; $dwz = file_get_contents($geturl, $param, stream_context_create($opts)); echo $dwz; ?>
var ajax = new XMLHttpRequest(); var token = 'd3be719c083dd26e0799ef70461baf36'; var longUrl = 'http://test.com/page/doc.html'; ajax.open('post','http://dwz.tax/api/create', 'true'); ajax.setRequestHeader("Content-Type", "application/x-www-form-urlencoded;"); // 发送请求 var Post = 'token='+token+'&longurl='+encodeURIComponent(longUrl)+'&format=text'; ajax.send(Post); ajax.onreadystatechange = function () { if (ajax.readyState === 4 && ajax.status === 200) { //获取缩短后的网址 console.log(ajax.responseText); } }
#!/usr/bin/python # -*- coding: utf-8 -*- import requests import urllib.parse import json url = 'http://dwz.tax/api/create' method = 'POST' content_type = 'application/x-www-form-urlencoded' # TODO: 设置Token token = 'd3be719c083dd26e0799ef70461baf36' # TODO:设置待创建的长网址 longurl = urllib.parse.quote("https://baidu.com") Post = 'token='+token+'&longurl='+longurl+'&format=text' # 发起请求 response = requests.post(url=url, data=Post, {'Content-Type':content_type}) # 读取响应 print(response.text)