API文档 - 凉心云短网址
短网址生成接口
| 接口地址：https://suo.al/api/create | |||
|---|---|---|---|
| 返回格式：json/text/jsonp | |||
| 请求方式：get/post | |||
| 请求示例：https://suo.al/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": "https://suo.al/1f",
"date": "2021-06-18 16:33:38"
}
短网址还原接口
| 接口地址：https://suo.al/api/query | |||
|---|---|---|---|
| 返回格式：json/text/jsonp | |||
| 请求方式：get/post | |||
| 请求示例：https://suo.al/api/query?format=json&dwz=https://suo.al/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": "https://suo.al//1f",
}
短网址还原接口
| 接口地址：https://suo.al/api/revise | |||
|---|---|---|---|
| 返回格式：json/text/jsonp | |||
| 请求方式：get/post | |||
| 请求示例：https://suo.al/api/revise?format=json&token=注册后获取&dwz=https://suo.al/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 = 'https://suo.al/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','https://suo.al/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 = 'https://suo.al/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)