API 调试工具 Skill

快速测试 API、生成请求代码、分析响应数据。

核心功能

功能	描述
快速测试	发送 GET/POST/PUT/DELETE 请求
代码生成

生成 curl/Python/Node.js/fetch 代码 | | 响应分析 | 格式化 JSON、提取字段、对比差异 | | 认证支持 | Bearer Token、Basic Auth、API Key |

使用方法

测试 API

测试 API: GET https://api.example.com/users

生成请求代码

为这个 API 生成 Python 代码: POST https://api.example.com/login

分析响应

分析这个 JSON 响应的结构

快速命令

GET 请求

bash

基础 GET

curl -s https://api.example.com/users

带参数

curl -s https://api.example.com/users?page=1&limit=10

带 Header

curl -s -H Authorization: Bearer TOKEN \ https://api.example.com/users

保存响应

curl -s https://api.example.com/users -o response.json

POST 请求

bash

JSON Body

curl -s -X POST https://api.example.com/users \
-H Content-Type: application/json \
-d {name: 张三, email: zhangsan@example.com}

Form Data

curl -s -X POST https://api.example.com/login \ -H Content-Type: application/x-www-form-urlencoded \ -d username=admin&password=123456

文件上传

curl -s -X POST https://api.example.com/upload \ -F file=@/path/to/file.jpg

PUT/PATCH/DELETE

bash

PUT（完整更新）

curl -s -X PUT https://api.example.com/users/1 \
-H Content-Type: application/json \
-d {name: 李四, email: lisi@example.com}

PATCH（部分更新）

curl -s -X PATCH https://api.example.com/users/1 \ -H Content-Type: application/json \ -d {name: 王五}

DELETE

curl -s -X DELETE https://api.example.com/users/1

认证方式

Bearer Token

bash
curl -s -H Authorization: Bearer YOUR_TOKEN \
https://api.example.com/protected

Basic Auth

bash
curl -s -u username:password \
https://api.example.com/protected

API Key

bash

Header 方式

curl -s -H X-API-Key: YOUR_KEY \
https://api.example.com/protected

Query 参数方式

curl -s https://api.example.com/protected?apikey=YOURKEY

代码生成

Python (requests)

python
import requests

url = https://api.example.com/users
headers = {
Authorization: Bearer TOKEN,
Content-Type: application/json
}

GET

response = requests.get(url, headers=headers) print(response.json())

POST

data = {name: 张三, email: zhangsan@example.com} response = requests.post(url, headers=headers, json=data) print(response.json())

Node.js (fetch)

javascript
const url = https://api.example.com/users;
const headers = {
Authorization: Bearer TOKEN,
Content-Type: application/json
};

// GET
fetch(url, { headers })
.then(res => res.json())
.then(data => console.log(data));

// POST
fetch(url, {
method: POST,
headers,
body: JSON.stringify({ name: 张三, email: zhangsan@example.com })
})
.then(res => res.json())
.then(data => console.log(data));

Node.js (axios)

javascript
const axios = require(axios);

const api = axios.create({
baseURL: https://api.example.com,
headers: { Authorization: Bearer TOKEN }
});

// GET
const { data } = await api.get(/users);

// POST
const { data: created } = await api.post(/users, {
name: 张三,
email: zhangsan@example.com
});

JavaScript (浏览器 fetch)

javascript
const url = https://api.example.com/users;

// GET
fetch(url, {
headers: { Authorization: Bearer TOKEN }
})
.then(r => r.json())
.then(console.log);

// POST
fetch(url, {
method: POST,
headers: { Content-Type: application/json },
body: JSON.stringify({ name: 张三 })
})
.then(r => r.json())
.then(console.log);

响应处理

格式化 JSON

bash

使用 jq

curl -s https://api.example.com/users | jq .

提取字段

curl -s https://api.example.com/users | jq .data[].name

提取数组

curl -s https://api.example.com/users | jq .data | length

Python 处理

python
import requests
import json

response = requests.get(https://api.example.com/users)
data = response.json()

美化输出

print(json.dumps(data, indent=2, ensure_ascii=False))

提取字段

names = [item[name] for item in data[data]] print(names)

计算统计

print(fTotal: {len(data[data])})

调试技巧

查看请求详情

bash

显示响应头

curl -i https://api.example.com/users

显示详细信息

curl -v https://api.example.com/users

显示时间统计

curl -w \nTime: %{time_total}s\n https://api.example.com/users

测试性能

bash

测试响应时间

curl -w DNS: %{timenamelookup}s\nConnect: %{timeconnect}s\nTTFB: %{timestarttransfer}s\nTotal: %{timetotal}s\n -o /dev/null -s https://api.example.com/users

批量测试

for i in {1..10}; do curl -w $i: %{time_total}s\n -o /dev/null -s https://api.example.com/users done

错误处理

bash

检查状态码

HTTPCODE=$(curl -s -o /dev/null -w %{httpcode} https://api.example.com/users)

if [ $HTTP_CODE -eq 200 ]; then
echo 成功
else
echo 失败: $HTTP_CODE
fi

重试机制

for i in {1..3}; do response=$(curl -s https://api.example.com/users) if [ $? -eq 0 ]; then echo $response break fi echo 重试 $i/3... sleep 2 done

常用 API 测试

测试 REST API

bash

列表

curl -s https://jsonplaceholder.typicode.com/posts | jq .[0:3]

详情

curl -s https://jsonplaceholder.typicode.com/posts/1 | jq .

创建

curl -s -X POST https://jsonplaceholder.typicode.com/posts \ -H Content-Type: application/json \ -d {title: 测试, body: 内容, userId: 1} | jq .

更新

curl -s -X PUT https://jsonplaceholder.typicode.com/posts/1 \ -H Content-Type: application/json \ -d {title: 更新后} | jq .

删除

curl -s -X DELETE https://jsonplaceholder.typicode.com/posts/1

测试 GraphQL

bash
curl -s -X POST https://graphql.example.com \
-H Content-Type: application/json \
-d {query: { users { id name } }} | jq .

注意事项

• - 敏感信息不要硬编码，使用环境变量
• 测试环境与生产环境分开
• 记录 API 调用日志
• 注意 API 限流

---

创建：2026-03-12 版本：1.0