lianzhuo-scenicspot
景点信息查询
通过，地区，景点名称等关键字查询景点信息，包括简介，地址，坐标，景点类型，级别，建议游玩时间，电话，网站，开放时间，门票价格等信息
调用价格
10 匠币/次
快速接入
保持统一返回结构，直接通过服务端发起请求即可接入。
https://openapi.toolkk.com/v1/lianzhuo-scenicspotcURL 示例
curl --request GET \
--url 'https://openapi.toolkk.com/v1/lianzhuo-scenicspot' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{}'Python 示例
import os
import requests
url = "https://openapi.toolkk.com/v1/lianzhuo-scenicspot"
payload = {}
headers = {
"Content-Type": "application/json",
"X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}
response = requests.get(url, headers=headers, params=payload, timeout=30)
response.raise_for_status()
print(response.json())Go 示例
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/lianzhuo-scenicspot"
payload := []byte("{}")
req, err := http.NewRequest("GET", endpoint, bytes.NewBuffer(payload))
if err != nil {
panic(err)
}
req.Header.Set("Content-Type", "application/json")
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, err := io.ReadAll(resp.Body)
if err != nil {
panic(err)
}
fmt.Println(string(body))
}Java 示例
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ToolkkExample {
public static void main(String[] args) throws Exception {
String payload = "{}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/lianzhuo-scenicspot"))
.method("GET", HttpRequest.BodyPublishers.ofString(payload))
.header("Content-Type", "application/json")
.header("X-API-Key", "YOUR_API_KEY")
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}PHP 示例
<?php
$endpoint = 'https://openapi.toolkk.com/v1/lianzhuo-scenicspot';
$payload = "{}";
$ch = curl_init($endpoint);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => [
'Content-Type: application/json',
'X-API-Key: YOUR_API_KEY',
],
CURLOPT_POSTFIELDS => $payload,
]);
$response = curl_exec($ch);
if ($response === false) {
throw new RuntimeException(curl_error($ch));
}
curl_close($ch);
echo $response;响应示例
{}示例用于理解返回结构，实际结果以接口返回为准。
- 鉴权方式
- 请求头传入 X-API-Key
- 默认限流
- 60 次/分钟
- 超时时间
- 5000 ms
服务端调用时，将 API Key 放在 X-API-Key 请求头中。
建议按 response code 与业务字段双重判断调用结果。
高频调用场景请结合速率限制与重试策略使用。
请求字段
从服务端发起请求，并在 X-API-Key 请求头中传入密钥。
暂无字段定义，请参考 JSON 示例与接口说明。
请求示例
{}- 鉴权方式
- 请求头传入 X-API-Key
- 默认限流
- 60 次/分钟
- 超时时间
- 5000 ms
响应字段
示例用于理解返回结构，实际结果以接口返回为准。
暂无字段定义，请参考 JSON 示例与接口说明。
响应示例
{}接口简介
接口能力、应用场景、使用限制与常见问题。
接口能力
按省、市或景点名称检索景点资料，支持分页获取记录。结果可包含名称、地址、经纬度、景点等级与类型、联系电话、网站、开放时间和推荐游览时间，并提供记录总数与总页数。接口用于获取和整理景点基础信息，不会生成行程、计算路线、办理预约或购买门票。是否适合出行仍需结合景区当天安排和用户需求判断。
应用场景
旅游资料页可按地区查询并展示景点名称、地址和联系方式；行程准备工具可将开放时间与推荐游览时间交给用户参考，由调用方安排顺序；景点目录可根据查询条件分批整理资料。不同地区可能出现同名景点，应结合所在地和地址确认对象。经纬度可以辅助定位，但接入地图前要确认坐标体系，不能直接假定适用于所有地图服务。
从输入到结果
先确定目标地区或景点名称，再按需要提交省、市、名称与页码条件。检查调用状态及返回说明后读取景点记录，保留本次查询条件和获取时间。记录总数与总页数用于了解结果规模，后续翻页时保持筛选条件一致，不自行推断每页固定条数。名称、地址、电话和时间字段为空时标注未提供；把推荐游览时间作为行程参考，不解释为门票有效期或保证完成游览的时长。
范围与限制
当前没有确认名称检索的精确或模糊规则、分页默认值、坐标体系、数据更新频率及景点全量覆盖。已确认的记录字段没有明确票价或预约库存，不能依据简介中提及门票就做实时比价、余票或下单承诺。开放时间、联系电话和网站信息可能发生变化，出行前应再次向景区确认；查询为空不证明景点不存在或已关闭，异常也不能当作正常无记录。
常见问题
能查询门票价格并购票吗？
目前确认的记录没有明确票价与库存定义，不能保证实时价格，也不提供购票或预约操作。
能直接用坐标绘制地图吗？
需要先确认返回坐标采用的体系，再与地图服务要求匹配，不能凭经纬度字段直接假定坐标标准。
推荐游览时间是开放时间吗？
两者不同。开放时间描述接待安排，推荐游览时间供行程准备参考，不是保证的游览时长。
查询不到就说明景点关闭了吗？
不能。还可能与地区、名称、分页或数据收录有关，应核对条件并向景区确认实际情况。