← 返回 Skills 市场
Http Api
作者
codenova58
· GitHub ↗
· v1.0.0
· MIT-0
273
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install http-api
功能描述
Shape HTTP/JSON APIs—resources and verbs, error payloads, pagination, idempotency, and docs. Use when designing new endpoints, reviewing PRs, or aligning tea...
使用说明 (SKILL.md)
HTTP API
Design and review HTTP-facing APIs (usually JSON): predictable URLs, honest status codes, and errors clients can build on—without duplicating everything your api-compat skill covers for long-lived versioning policy.
Scope
- Modeling: nouns/resources, collections, actions when RPC-style is clearer than fake REST.
- HTTP semantics: which methods, idempotency, caching headers when relevant.
- Errors: stable machine-readable codes, correlation ids, avoid leaking internals.
- DX: examples, OpenAPI snippets, consistent pagination/filter patterns.
Out of scope (hand off)
- OAuth/OIDC protocol details → identity-focused skills.
- GraphQL-only schema design → graphql-schema skill.
- Multi-year deprecation policy and client migration programs → pair with api-compat.
Review order
- Read paths — Can a client navigate the domain without guessing?
- Write safety — Retries safe? Duplicate submits handled?
- Errors — One shape everywhere; 4xx vs 5xx honest.
- Evolution — Document what may change vs what is stable (compat details in api-compat).
Smells
- Status 200 with
{error: ...}; every POST returns 200; unbounded list endpoints; secrets in error bodies.
Done when
- A new engineer can call the API from docs alone; failure cases are testable and consistent.
安全使用建议
This skill is an offline, text-only guide for designing and reviewing HTTP/JSON APIs and does not access credentials or your filesystem. It appears safe and coherent to install, but remember: it's advice—validate any suggested changes against your organization's security, compatibility, and operational policies before applying them. If you need machine-executable checks or integrations (tests, CI automation, versioning policies), look for or request a skill that explicitly declares those capabilities and the minimal required credentials or install steps.
功能分析
Type: OpenClaw Skill
Name: http-api
Version: 1.0.0
The skill bundle contains only metadata and documentation (SKILL.md) focused on best practices for HTTP API design and review. It provides architectural guidance on RESTful conventions, error handling, and idempotency without any executable code, external dependencies, or suspicious instructions.
能力评估
Purpose & Capability
The name/description (HTTP API design and reviews) matches the SKILL.md content. There are no environment variables, binaries, or config paths requested that would be unrelated to API design.
Instruction Scope
SKILL.md contains only prose-level guidance for API modeling, HTTP semantics, errors, DX, and review order. It does not instruct the agent to read files, access environment variables, call external endpoints, or collect user/system data.
Install Mechanism
No install specification and no code files are present (instruction-only). Nothing will be written to disk or downloaded as part of installation.
Credentials
The skill requests no environment variables, credentials, or configuration paths; nothing disproportionate is requested for the stated design/review purpose.
Persistence & Privilege
Skill flags show default behavior (not always: true) and model invocation is allowed (platform default). There is no indication the skill tries to persist or modify other skills or system-wide configuration.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install http-api - 安装完成后，直接呼叫该 Skill 的名称或使用
/http-api触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release of the http-api skill.
- Guides on designing and reviewing RESTful HTTP/JSON APIs, focusing on clarity and consistency.
- Covers resource modeling, HTTP methods, status codes, error shape, idempotency, and common DX patterns.
- Outlines clear review steps and API "smells" to avoid.
- Specifies boundaries with related skills (api-compat, graphql-schema, authentication).
- Emphasizes self-serve documentation and robust error handling.
元数据
常见问题
Http Api 是什么？
Shape HTTP/JSON APIs—resources and verbs, error payloads, pagination, idempotency, and docs. Use when designing new endpoints, reviewing PRs, or aligning tea... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 273 次。
如何安装 Http Api？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install http-api」即可一键安装，无需额外配置。
Http Api 是免费的吗？
是的，Http Api 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Http Api 支持哪些平台？
Http Api 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Http Api？
由 codenova58（@codenova58）开发并维护，当前版本 v1.0.0。
推荐 Skills