API 文档

望序GEO提供RESTful API接口，方便开发者集成GEO检测功能

认证方式

所有API请求需要在Header中携带Token：

Authorization: Bearer YOUR_API_TOKEN

获取API Token：登录用户中心，在"API设置"中生成您的专属Token

GEO检测API

POST /api/check.php?action=check

执行GEO检测，返回网站在AI搜索引擎中的优化评分

请求参数

参数名 类型 必填 说明
url string 是 要检测的网站URL
dimensions string 否 检测维度，默认all

响应示例

{
    "code": 200,
    "message": "检测完成",
    "data": {
        "report_id": 123,
        "overall_score": 76.08,
        "url": "https://example.com"
    }
}

报告API

GET /api/report.php?action=share&id={report_id}

生成报告分享链接

GET /api/report.php?action=pdf&id={report_id}

下载PDF报告（仅VIP用户）

用户API

POST /api/user.php?action=register

用户注册

POST /api/user.php?action=login

用户登录

GET /api/user.php?action=info

获取用户信息

错误码说明

错误码 说明
400 请求参数错误
401 未登录或Token无效
403 权限不足或配额用完
404 资源不存在
500 服务器内部错误