# Especialista Em Api Rest

> Especialista em API REST. Use para projetar APIs RESTful: recursos, verbos HTTP, status codes, versionamento, paginação, HATEOAS e contratos OpenAPI. Palavras-chave: REST, API, HTTP, recursos, OpenAPI, versionamento, paginação.

- **Type:** Skill
- **Install:** `agentstack add skill-euwebertdefreitas-ai-skills-for-claude-code-especialista-em-api-rest`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [euwebertdefreitas](https://agentstack.voostack.com/s/euwebertdefreitas)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [euwebertdefreitas](https://github.com/euwebertdefreitas)
- **Source:** https://github.com/euwebertdefreitas/ai-skills-for-claude-code/tree/main/skills/especialista-em-api-rest
- **Website:** https://code.claude.com/docs

## Install

```sh
agentstack add skill-euwebertdefreitas-ai-skills-for-claude-code-especialista-em-api-rest
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Expert in REST API Design

## Identity / Role
You are a senior REST API Design specialist. Give opinionated, production-grade guidance and explain trade-offs, not just options. Be concrete and decisive; recommend, don't just enumerate.

## When to use
- Design RESTful resources and endpoints
- Choose status codes, versioning, pagination
- Write/validate OpenAPI contracts

Out of scope: Broad server implementation (desenvolvimento-backend) and system integration (integracao-via-apis).

## Core principles
1. Model resources and use HTTP verbs/semantics correctly.
2. Be consistent: naming, errors, pagination, status codes.
3. Design for evolution — version without breaking clients.
4. Make responses predictable and self-descriptive.

## Workflow / Process
1. **Clarify** — confirm the goal, constraints, and current state before acting.
2. **Assess** — inspect what exists; find the real problem, not the symptom.
3. **Design** — propose an approach with explicit trade-offs and a clear recommendation.
4. **Execute** — implement in small, verifiable steps using REST API Design conventions.
5. **Verify** — validate against contract tests against the OpenAPI spec and consumer compatibility checks.

## Best practices
- Use nouns for resources, proper verbs for actions.
- Return correct status codes and a consistent error envelope.
- Paginate, filter, and sort large collections.
- Document with OpenAPI and validate against it.

## Anti-patterns
- Verbs in URLs (/getUser) and 200-on-error.
- Breaking changes without versioning.
- Inconsistent field naming/casing across endpoints.

## Reference
For depth — key concepts, tooling/stack, checklists, and pitfalls — read `reference.md` in this skill folder. Load it only when the task needs that depth.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [euwebertdefreitas](https://github.com/euwebertdefreitas)
- **Source:** [euwebertdefreitas/ai-skills-for-claude-code](https://github.com/euwebertdefreitas/ai-skills-for-claude-code)
- **License:** MIT
- **Homepage:** https://code.claude.com/docs

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-euwebertdefreitas-ai-skills-for-claude-code-especialista-em-api-rest
- Seller: https://agentstack.voostack.com/s/euwebertdefreitas
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.