30P by xguru 2022-01-26 | favorite | 댓글 4개

- "AWS가 15년간 배운 좋은 API를 만드는 6가지 원칙" 에 대한 메모
1. API는 영원하다!
2. 하위 호환성을 지켜주세요.
3. 고객 사용 사례에서 거꾸로 만드세요.
4. 오류가 명시적인 API를 만드세요.
5. 바로 목적과 사용법을 이해할 수 있는 API를 만드세요.
6. 구현 세부 정보는 누출되지 않게 신경을 쓰세요.

- 초기 API 설계에서 실수하는 것
- Smithy를 통한 확장성 높은 API 만들기

- 아마존 역사에서 가장 중요한 제프베조스의 2002년 사내 메일 https://news.hada.io/topic?id=638

저는 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)

이렇게 정리해두면 당연한 것 처럼 보이는데 또 실제로 할때는 반복해서 실수하는 것이다 싶습니다.