API 설계 가이드

핵심 원칙

1. 명확하고 예측 가능하게

API를 처음 보는 개발자가 문서 없이도 80% 이해할 수 있어야 합니다.

2. 일관성이 최우선

좋은 규칙을 일관되게 따르는 것이, 완벽한 규칙을 불규칙하게 따르는 것보다 낫습니다.

3. 개발자 경험(DX) 중심

API는 개발자를 위한 제품입니다. 사용하기 쉬워야 합니다.

URL 설계 원칙

✅ 좋은 URL 설계