系统讲解自建GEO API的设计方法，包括RESTful接口设计、数据模型、认证授权、速率限制，以及GEO API的最佳实践和性能优化。
自建GEO API为团队提供统一的GEO数据访问和操作接口，是GEO平台化的基础。
| 接口 | 方法 | 路径 | 功能 |
|---|---|---|---|
| 可见性查询 | GET | /api/v1/visibility | 查询关键词在各AI引擎的可见性得分 |
| 引用数据 | GET | /api/v1/citations | 获取被AI引用的详细数据 |
| Schema管理 | POST/PUT | /api/v1/schemas | 创建和更新Schema模板 |
| 内容评分 | POST | /api/v1/score | 评估内容页面的GEO得分 |
| 追踪任务 | POST | /api/v1/tracking | 创建和管理GEO追踪任务 |
| 报告生成 | POST | /api/v1/reports | 生成GEO分析报告 |
GEO API的数据模型需要支持多维度查询和时序分析。
GEO API需要完善的认证和授权机制，保护敏感的GEO数据。
使用API Key + HMAC签名双重认证
按角色设置API访问权限（只读/读写/管理）
API Key与项目/站点绑定，支持权限隔离
所有API调用记录审计日志
敏感操作需要二次确认
GEO API可能面临较高的查询压力，需要做好速率限制和性能优化。