接口速览

• 接口名称：随机风景API
• 请求方式：GET/POST
• 接口地址：https://api.mangox.asia/api/spfj
• 请求参数：共 2 个，其中必填 1 个
• 返回格式：JSON
• 费用说明：完全免费，无需付费，不限调用次数
• 当前状态：运行正常

使用 GET/POST 方式请求以下地址即可获取数据。 若接口需要密钥，点击 填充 Token，示例地址与代码中的「您的密钥」会自动替换为你的 token。

<?php
$url = "https://api.mangox.asia/api/spfj?token=您的密钥";

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 10,
    CURLOPT_CUSTOMREQUEST  => "GET/POST",
]);
$response = curl_exec($ch);
curl_close($ch);

echo $response;

接口信息

接口地址（api-url）

https://api.mangox.asia/api/spfj 复制

请求方式

GET/POST

示例地址

https://api.mangox.asia/api/spfj?token=您的密钥 复制

请求参数

返回示例

image格式的图片（302重定向）

状态码说明

常见问题

如何调用 随机风景API 接口？

使用 GET/POST 方式请求 https://api.mangox.asia/api/spfj，按需携带「请求参数」中的字段即可获取返回数据。若接口需要密钥，请在本页「快速开始」处点击「填充 Token」，输入后示例地址与代码中的「您的密钥」会自动替换为你的 token，直接复制即可使用。

随机风景API 接口支持哪些请求方式？

目前支持 GET/POST 请求方式，请求地址为 https://api.mangox.asia/api/spfj。接口同时兼容 cURL、Python requests、Java HttpClient、JavaScript fetch 等常见客户端。

随机风景API 接口是免费的吗？

是的，该接口由 MGO-API 免费开放，无需付费即可调用，也不限制调用次数（合理使用即可）。

调用 随机风景API 接口返回错误怎么办？

请对照「状态码说明」排查：400 参数错误（检查参数名与类型）、403 无效密钥（检查 token 是否正确）、404 源站缺失（源站资源不存在）、408 请求超时（稍后重试或降低并发）、410 解析失败（源站内容已失效）、422 解析错误（源站返回格式异常）。若持续报错，可联系站长协助处理。

接口提示「无效密钥 / 403」该如何处理？

请确认 token 参数是否正确、是否已过期。可在本页「快速开始」中点击「填充 Token」，输入你的密钥后，示例地址与代码里所有「您的密钥」占位内容都会自动替换，直接复制即可使用。

接口响应很慢或者超时（408）怎么办？

可先重试一次；若仍超时，可能是源站临时波动。建议客户端设置 10 秒以上超时，并避免高频并发请求，稍后再试通常即可恢复。

如何导出这份接口文档？

在页面顶部点击「导出文档」按钮，在弹出的窗口中选择 Markdown（.md）、Word（.doc）或纯文本（.txt）格式，导出文件会附带站点域名、原文档地址与导出时间，方便离线查阅或写进项目文档。也可以在地址后追加 &format=json 获取结构化 JSON，或追加 &format=md 获取 Markdown 纯文本，便于 AI 与程序抓取。

遇到问题如何联系站长？

节假日白天可联系站长 QQ：2201040041（其他时段留言即可，看到会尽快回复）。