HTTP 请求

当需要发起 HTTP API 调用，且使用 curl 进行引号转义或字符串拼接容易出错时，请使用此技能。

该技能的功能

• 通过 Python requests 库发送 HTTP 请求
• 支持 GET、POST、PUT、DELETE 方法
• 支持请求头、查询参数、JSON 请求体、表单数据及超时设置
• 在 logs/ 目录下生成轻量级的每日 JSONL 格式日志文件
• 默认不记录敏感信息，如授权令牌和完整的请求/响应体

执行前需收集的输入

在运行脚本前，请准备好以下信息：

• 请求方法：GET / POST / PUT / DELETE
• 请求地址（URL）
• 请求头（如有）
• 查询参数（如有）
• JSON 请求体或表单数据（如有）
• 超时时间（如用户有特殊要求，否则使用默认值）

脚本说明

主脚本文件：

• scripts/request_http.py

使用 Python 运行该脚本，并传入请求方法、URL 及可选参数。

日志记录

日志文件存储于本技能目录中：

• logs/YYYY-MM-DD.jsonl

每行日志仅包含简要摘要信息：

• 时间戳
• 请求方法
• URL
• 状态码
• 是否成功（ok）
• 响应耗时（毫秒）
• 响应体大小（字节）
• 错误信息（如有）

默认情况下，不会记录授权令牌、Cookie 或完整的请求/响应体。

何时查阅参考文档

请阅读 references/usage-patterns.md 当：

• 请求包含多个请求头、参数或复杂的数据字段
• 用户需要示例使用模式
• 需要在 JSON 请求体与表单数据之间进行选择
• 需要了解脚本的命令行参数格式