본문으로 건너뛰기
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(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

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 / 1,000자

이 양식은 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의 스킬 모두 보기

이 스킬의 문제 신고