API使用文档

CRTraveler 站点查询 API

接口地址:https://api.crtraveler.top

参数说明

参数名 说明
token 必须传入,授权密钥
code 站点编码,自动转大写
name 站点名称,模糊查询
pinyin 站点拼音,自动转小写
• token 必传
• code / name / pinyin 至少传一项
• 可传 1/2/3 项,不可全为空

请求示例

https://api.crtraveler.top?token=test123&name=成都
https://api.crtraveler.top?token=test123&code=icw
https://api.crtraveler.top?token=test123&pinyin=cdd

正常返回示例

{
“code”: 200,
“msg”: “成功”,
“data”: [
{
“code”: “CDW”,
“name”: “成都站”,
“pinyin”: “chengdu”
}
],
“total_used”: 5,
“total_left”: 995,
“min_used”: 3,
“min_left”: 57
}

无数据返回示例

{
“code”: 404,
“msg”: “无数据”,
“data”: [],
“total_used”: 6,
“total_left”: 994,
“min_used”: 4,
“min_left”: 56
}

PHP 调用示例

<?php
$params = [
    'token'  => 'test123',
    'code'   => 'CDW',
    'name'   => '成都'
];

$url = 'https://api.crtraveler.top?' . http_build_query($params);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>

Python 调用示例

import requests
params = {
    "token": "test123",
    "name": "成都"
}
resp = requests.get("https://api.crtraveler.top", params=params)
print(resp.json())

JavaScript 调用示例

const params = new URLSearchParams({
  token: "test123",
  name: "成都"
})
fetch("https://api.crtraveler.top?" + params)
  .then(res => res.json())
  .then(data => console.log(data))

在线测试





返回字段说明

code 状态码
msg 提示信息
data 站点数据
total_used 已用次数
total_left 剩余次数
min_used 分钟已用
min_left 分钟剩余

状态码说明

200 成功
401 Token 无效
402 次数已用完
404 无数据
429 请求频繁

特殊请求说明

– 参数”pinyin”不同于一般拼音,此参数应输入拼音首字母。例:成都东(cdd)、北京西(bjx)

– 参数“code”与参数“pinyin”大小写均可

最新活动

– Token大放送,由于API新开发,为增大流量,决定免费公开一不限次数Token,此Token调用次数无上限,每分钟总限制调用6000次!欢迎尝试!

Token: API.CRTRAVELER.TOP