跳到正文
cccskills
免费在 GitHub 公开

api-versioning

API versioning: breaking/non-breaking changes, deprecation headers, sunset, v2 introduction. Go/Gin, NestJS, Fastify, GraphQL.

中文简介正在准备中。当前显示原文说明。

SebastianLuser/claude-code-arcane星标 3(GitHub 3 + cccskills 0)

实测评分 未实测

查看安装方法

包含的文件(3)

  • SKILL.md2.2 KB
  • references/anti-patterns-and-checklist.md1.0 KB
  • references/implementation-by-framework.md1.1 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

API Versioning

Guía para versionar APIs en backends Educabot (Go + TS) consumidas por web (React+Vite) y mobile (React Native).

Estrategias

EstrategiaEjemploVeredicto
URL path/v1/usersDefault Educabot — visible, cacheable, fácil
HeaderAPI-Version: 2026-01-15Complemento opcional (date-based pinning)
Query param/users?version=2Evitar — ensucia URLs, problemas caché
Content negotiationAccept: vnd.educabot.v2+jsonEvitar — over-engineering

Solo MAJOR cambia URL (/v1 → /v2). MINOR/PATCH transparentes.

Breaking vs Non-breaking

Non-breaking (no requiere v2): agregar campo opcional request/response, nuevo endpoint, nuevo enum value (si clientes toleran desconocidos), relajar validaciones, required → opcional.

Breaking (requiere v2): remover campo response, cambiar tipo, renombrar campo/endpoint, cambiar status codes, opcional → required, cambiar formato fechas/IDs/paginación, cambiar semántica, endurecer validaciones.

Deprecation Flow

  1. Anunciar — changelog, email, ticket de migración
  2. Headers en runtime — Deprecation: true + Sunset: <date> + Link: <migration-docs> + Warning: 299
  3. Monitorear uso — log hits con user-agent/client_id, dashboard quién usa v1
  4. Recordatorios — 1 mes y 1 semana antes del sunset
  5. Apagar — 410 Gone con body apuntando a docs

Ventanas de Soporte

ContextoVentana
Web (React)6 meses
Mobile (RN)12 meses + minimum-version forcing
API externa12+ meses
Backend internoSemanas (coordinando deploys)

Max 2 majors vivas en paralelo. Nunca 3+.

→ Read references/implementation-by-framework.md for implementation patterns per framework (Go, NestJS, Fastify, OpenAPI, GraphQL, Mobile)

→ Read references/anti-patterns-and-checklist.md for anti-patterns list and v2 introduction checklist

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Plan, design, and implement A/B tests and experiments with statistical rigor. Covers hypothesis frameworks, sample sizing, metrics, and result analysis.

中文简介正在准备中。当前显示原文说明。

SebastianLuser/claude-code-arcane32026年10月27日 更新

Web/mobile accessibility decision guide: WCAG 2.2 AA, ARIA, keyboard nav, focus management, contrast, testing. Use for: a11y, accessibility, wcag, aria, screen reader, keyboard, contrast.

中文简介正在准备中。当前显示原文说明。

SebastianLuser/claude-code-arcane32026年10月27日 更新

Generate, iterate, and scale ad creative for paid advertising across Google, Meta, LinkedIn, and X. Covers platform specs, creative frameworks, and quality validation.

中文简介正在准备中。当前显示原文说明。

SebastianLuser/claude-code-arcane32026年10月27日 更新

Musica interactiva para juegos: layering vertical, re-secuenciacion horizontal, stingers, reglas de transicion con sync points, y mapeo de estados de gameplay a musica. Usar para: musica adaptativa, sistema de musica dinamica, transiciones musicales, combat music.

中文简介正在准备中。当前显示原文说明。

SebastianLuser/claude-code-arcane32026年10月27日 更新

Design multi-agent systems, create agent architectures, define communication patterns, and build autonomous agent workflows with structured evaluation frameworks.

中文简介正在准备中。当前显示原文说明。

SebastianLuser/claude-code-arcane32026年10月27日 更新

Inter-agent communication protocol for C-suite agent teams. Defines invocation syntax, loop prevention, isolation rules, response formats, and quality loops.

中文简介正在准备中。当前显示原文说明。

SebastianLuser/claude-code-arcane32026年10月27日 更新

查看 SebastianLuser 的全部技能

报告此技能的问题