Skip to content
cccskills
FreePublished on GitHub

api-patterns

Princípios de design de API e tomada de decisão. Seleção REST vs GraphQL vs tRPC, formatos de resposta, versionamento, paginação.

The English summary is being prepared. Showing the original description.

See how to install

Files included (12)

  • SKILL.md2.7 KB
  • api-style.md1.1 KB
  • auth.md576 B
  • documentation.md549 B
  • graphql.md977 B
  • rate-limiting.md726 B
  • response.md921 B
  • rest.md1.3 KB
  • scripts/api_validator.py7.4 KB
  • security-testing.md2.8 KB
  • trpc.md801 B
  • versioning.md651 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Padrões de API

Princípios de design de API e tomada de decisão para 2025. Aprenda a PENSAR, não copie padrões fixos.

🎯 Regra de Leitura Seletiva

Leia APENAS os arquivos relevantes para a solicitação! Verifique o mapa de conteúdo, encontre o que você precisa.


📑 Mapa de Conteúdo

ArquivoDescriçãoQuando Ler
api-style.mdÁrvore de decisão REST vs GraphQL vs tRPCEscolhendo tipo de API
rest.mdNomenclatura de recursos, métodos HTTP, códigos de statusProjetando API REST
response.mdPadrão envelope, formato de erro, paginaçãoEstrutura de resposta
graphql.mdDesign de schema, quando usar, segurançaConsiderando GraphQL
trpc.mdMonorepo TypeScript, segurança de tipoProjetos fullstack TS
versioning.mdVersionamento por URI/Header/QueryPlanejamento de evolução de API
auth.mdJWT, OAuth, Passkey, API KeysSeleção de padrão de autenticação
rate-limiting.mdToken bucket, janela deslizanteProteção de API
documentation.mdMelhores práticas OpenAPI/SwaggerDocumentação
security-testing.mdOWASP API Top 10, testes de autenticação/autorizaçãoAuditorias de segurança

🔗 Habilidades Relacionadas

NecessidadeHabilidade
Implementação de API@[skills/backend-development]
Estrutura de dados@[skills/database-design]
Detalhes de segurança@[skills/security-hardening]

✅ Checklist de Decisão

Antes de projetar uma API:

  • Perguntou ao usuário sobre os consumidores da API?
  • Escolheu o estilo de API para ESTE contexto? (REST/GraphQL/tRPC)
  • Definiu formato de resposta consistente?
  • Planejou estratégia de versionamento?
  • Considerou necessidades de autenticação?
  • Planejou rate limiting?
  • Abordagem de documentação definida?

❌ Anti-Padrões

NÃO FAÇA:

  • Use REST por padrão para tudo
  • Use verbos em endpoints REST (/getUsers)
  • Retorne formatos de resposta inconsistentes
  • Exponha erros internos aos clientes
  • Pule rate limiting

FAÇA:

  • Escolha o estilo de API baseado no contexto
  • Pergunte sobre os requisitos do cliente
  • Documente minuciosamente
  • Use códigos de status apropriados

Script

ScriptPropósitoComando
scripts/api_validator.pyValidação de endpoint de APIpython scripts/api_validator.py <project_path>

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Especialista em construir experiências 3D para a web - Three.js, React Three Fiber, Spline, WebGL e cenas 3D interativas. Cobre configuradores de produtos, portfólios 3D, websites imersivos e adição de profundidade às experiências web. Use quando: website 3D, three.js, WebGL, react three fiber, experiência 3D.

The English summary is being prepared. Showing the original description.

artubss/SKILLS-CLAUDE-CODE11Updated May 17, 2026

Quando o usuário quer planejar, projetar ou implementar um teste A/B ou experimento. Também use quando o usuário menciona "teste A/B", "split test", "experimento", "testar essa mudança", "copy variante", "teste multivariado" ou "hipótese". Para implementação de rastreamento, veja analytics-tracking.

The English summary is being prepared. Showing the original description.

artubss/SKILLS-CLAUDE-CODE11Updated May 17, 2026

Auditar e melhorar a acessibilidade web seguindo as diretrizes WCAG 2.1. Use quando solicitado para "melhorar acessibilidade", "auditoria a11y", "conformidade WCAG", "suporte a leitor de tela", "navegação por teclado" ou "tornar acessível".

The English summary is being prepared. Showing the original description.

artubss/SKILLS-CLAUDE-CODE11Updated May 17, 2026

Testes e benchmarking de agentes LLM incluindo testes comportamentais, avaliação de capacidades, métricas de confiabilidade e monitoramento em produção—onde até os melhores agentes alcançam menos de 50% em benchmarks do mundo real. Use quando: testes de agentes, avaliação de agentes, benchmark de agentes, confiabilidade de agentes, teste de agentes.

The English summary is being prepared. Showing the original description.

artubss/SKILLS-CLAUDE-CODE11Updated May 17, 2026

Criar, gerenciar e orquestrar agentes de IA usando o CLI AI Maestro. Use quando o usuário pedir para "criar agente", "listar agentes", "deletar agente", "hibernar agente", "despertar agente", "instalar plugin", "mostrar agente", "reiniciar agente" ou qualquer tarefa de gerenciamento do ciclo de vida do agente.

The English summary is being prepared. Showing the original description.

artubss/SKILLS-CLAUDE-CODE11Updated May 17, 2026

Gerencie múltiplos agentes CLI locais via sessões tmux (iniciar/parar/monitorar/atribuir) com agendamento compatível com cron.

The English summary is being prepared. Showing the original description.

artubss/SKILLS-CLAUDE-CODE11Updated May 17, 2026

See all skills by artubss

Report a problem with this skill