Werner Vogels – 좋은 API 디자인을 위한 6가지 배운 점
(aws.amazon.com)- "AWS가 15년간 배운 좋은 API를 만드는 6가지 원칙" 에 대한 메모
1. API는 영원하다!
2. 하위 호환성을 지켜주세요.
3. 고객 사용 사례에서 거꾸로 만드세요.
4. 오류가 명시적인 API를 만드세요.
5. 바로 목적과 사용법을 이해할 수 있는 API를 만드세요.
6. 구현 세부 정보는 누출되지 않게 신경을 쓰세요.
- 초기 API 설계에서 실수하는 것
- Smithy를 통한 확장성 높은 API 만들기
저는 5번이 와닿았습니다.
참조되어 있는 "그런 REST API로 괜찮은가"는 전에 본적이 있는데 좋았어요: https://tv.naver.com/v/2292653
이런 시멘틱? 정보는 신경쓰지 않는데, Github API를 보면 이런 정보도 잘 내려주고 있어서 잘 만들었다는 느낌이 듭니다.
좋은 내용인 것 같습니다.
특히 1, 4번은 리뷰를 할 때 항상 얘기하게 되는 항목인 것 같네요.
3번은 Joshua Bloch가 얘기했던 "Write to Your API Early and Often"와 닿아있는 부분인 것 같습니다. (https://www.youtube.com/watch?v=aAb7hSCtvGw)