公共 API 调用入口

Model: qwen-plus | ¥0.02/call

API 调用公共 APIapisREST 调用

公共 API 调用入口 apis-slug：传入 slug 调用任意公共 API 的顶层 GET 端点。先用 apis-catalog 查 slug。支持统一处理流程。

Skill Documentation

---

name: apis-slug

description: 公共 API 调用入口 apis-slug：传入 slug 调用任意公共 API 的顶层 GET 端点。先用 apis-catalog 查 slug。支持统一处理流程。

---

⚠️ chat 模式使用须知（重要）

本 skill 的真实能力依赖平台后端工具。在网页 / chat 端点下，这些工具可能不可用：

若 chat 返回「无法调用真实工具 / 外部接口」，说明未真正执行；
若结果明显为编造（凭空生成数据却标注「已搜索 / 已完成 / ✅」），也是未真正执行。

此时**请勿轻信**，请改用 **agent / CLI 路径**运行本 skill 以获取真实结果。任何路径下都**严禁谎称「已调用 / 已搜索完成」而实际未执行**。

公共 API 调用入口（apis-slug）

调 AIMS 平台 apis.slug 工具，传入 API slug 直接拿顶层 GET 响应。完全免费，适合快速测试某个 API。

典型使用场景

**场景 1：API 试用** —— 看到 apis-catalog 列出 "openweather" slug，想试一下 → 用 apis-slug 直接调用拿响应。

**场景 2：API 元数据** —— 拿某个 API 的 swagger / OpenAPI 文档信息。

**场景 3：API 健康检查** —— 看某个 API 是否还能访问。

适用人群

| 角色 | 典型用途 |

|------|----------|

| 后端开发 | 试用免密钥 API |

| API 集成方 | 测试 API 可用性 |

完整数据示例（实测）

python scripts/apis_slug.py --slug openweather

返回示例：API 顶层 GET 响应（JSON / markdown / 视 API 而定）。

为什么选 apis-slug

✅ **不需要 key**：免密钥公共 API 直接调用
✅ **完全免费**：不计费
✅ **零门槛**：传入 slug 一行命令拿响应

触发条件

用户说"调用公共 API"、"试 XXX API"、"openweather 怎么调"、"免密钥 API 调用"时触发。

文件：scripts/apis_slug.py

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""apis/{slug} 顶层端点调用 —— 调任意公共 API 的 GET 顶层。

用法：
  python scripts/apis_slug.py --slug openweather [--api-key aims_sk_xxx]

可先用 apis-catalog 列出所有可用 slug。
"""
import argparse
import json
import sys
from pathlib import Path

sys.path.insert(0, str(Path(__file__).resolve().parent.parent.parent / "_lib"))
from aims_functional_api import apis_slug


def main():
    ap = argparse.ArgumentParser(description="apis/{slug} 顶层调用")
    ap.add_argument("--slug", required=True, help="API slug（如 openweather）")
    ap.add_argument("--api-key", default=None)
    args = ap.parse_args()

    try:
        result = apis_slug(slug=args.slug, api_key=args.api_key)
        print(json.dumps({"ok": True, "slug": args.slug, "result": result}, ensure_ascii=False, indent=2))
    except Exception as e:
        print(json.dumps({"ok": False, "error": str(e)}, ensure_ascii=False))
        sys.exit(1)


if __name__ == "__main__":
    main()

Open AIMS China Panel