用途:帮助开发者完成 ALAPI 平台的接口检索、文档读取、参数提取、代码生成与按需真实调用。
主要能力:通过零依赖脚本 scripts/alapi.py 提供 search(搜索接口)、explore(浏览全部接口)、detail(读取基础信息)、openapi(读取 OpenAPI 规格)、call(发起真实请求)等命令,支持 --json 输出稳定 JSON 供后续处理。平台约定 Base URL 为 https://v3.alapi.cn,文档页为 https://www.alapi.cn/api/{id}/introduction,Token 创建地址为 https://www.alapi.cn/dashboard/data/token,所有接口需传 token,通常放在 GET query 或 POST body。
使用方式:优先从当前 skill 目录推导脚本路径,例如 SKILL_DIR=/absolute/path/to/alapi、SCRIPT="$SKILL_DIR/scripts/alapi.py",再执行 python3 "$SCRIPT" --json search "IP查询"。用户给出文档 URL 时提取 api/{id} 后读取 OpenAPI;只描述功能时先搜索,命中多个候选先列 2 到 5 个供确认;搜索无结果时按去修饰词、换同义词、拆词等顺序回退 2 到 3 轮。仅在用户明确要求真实调用且提供 token 时执行 call,token 优先级为显式 --token 高于环境变量 ALAPI_TOKEN。
适用场景:接口选型与文档查询、生成最小可运行对接代码、按需测试接口。代码生成默认使用 ALAPI_TOKEN 占位符,Python 用 requests、JS/TS 用 fetch、PHP 用 curl、Go 用 net/http,保留 success/code/message/data/request_id/time 的解析与错误处理;服务端项目建议将 token 放环境变量或服务端配置,浏览器端默认不直连。
限制:默认只做只读操作;不手工猜文档接口路径;不假设工作目录;不回显真实 token;候选未确认前不输出最终代码;参数不足时不猜值;OpenAPI 未写清时不编造参数、默认值或响应字段;call 失败时保留平台原始错误结构。错误码 401 检查 token、403 套餐不含接口、422 参数校验失败、429 频率超限、500 服务端错误。搜索结果为空时说明无匹配接口并建议更明确关键词;openapi 缺失但 detail 或文档页存在时说明规范不完整并退回基础信息与文档链接。