rest-endpoint-conventions

AgentsRoom 작성AgentsRoom 인증아직 설치 없음아직 좋아요 없음2026년 5월 7일 업데이트카테고리: 엔지니어링

무엇을 하나요

Use when adding or modifying a REST endpoint. Enforces the project's auth check, validation, error shape and pagination conventions.

설치를 누르면 이 항목이 AgentsRoom 데스크톱 앱에서 열립니다. 앱이 아직 설치되어 있지 않으면 다운로드 페이지로 이동합니다.

SKILL.md

---
name: rest-endpoint-conventions
description: Use when adding or modifying a REST endpoint. Enforces the project's auth check, validation, error shape and pagination conventions.
---

# REST endpoint conventions

When adding or modifying a REST endpoint:

1. Auth check FIRST: 401 if unauthenticated, 403 if forbidden — never silently empty.
2. Validate the input with the project's existing validation lib (zod, joi, ...) — do not introduce a new one.
3. Errors return `{ error: "CODE", message: "<human-readable>" }`. Status codes follow REST semantics (400 / 404 / 409 / 422 / 500).
4. List endpoints paginate by default (cursor or offset, match what the project already does).
5. Side effects (emails, webhooks) fire AFTER the DB commit, never inside the transaction.

태그

backendapirest

더 알아보기

Claude Ads: 광고 계정을 감사해 주는 Claude Code 스킬

Claude Ads는 Claude Code용 오픈소스 스킬입니다. Google과 Meta부터 Reddit, X까지 12개 플랫폼의 광고 계정을 감사하고, 모든 발견 사항에 근거를 붙입니다. v2.1.0이 하는 일, 안전하게 설치하는 방법, 한계, 그리고 AgentsRoom에서 실행하는 방법을 정리했습니다.