# Werner Vogels – 좋은 API 디자인을 위한 6가지 배운 점

> Clean Markdown view of GeekNews topic #5823. Use the original source for factual precision when an external source URL is present.

## Metadata

- GeekNews HTML: [https://news.hada.io/topic?id=5823](https://news.hada.io/topic?id=5823)
- GeekNews Markdown: [https://news.hada.io/topic/5823.md](https://news.hada.io/topic/5823.md)
- Type: news
- Author: [xguru](https://news.hada.io/@xguru)
- Published: 2022-01-26T09:40:15+09:00
- Updated: 2022-01-26T09:40:15+09:00
- Original source: [aws.amazon.com](https://aws.amazon.com/ko/blogs/korea/werner-vogels-lesson-learned-for-good-api-design/)
- Points: 30
- Comments: 4

## Topic Body

- "AWS가 15년간 배운 좋은 API를 만드는 6가지 원칙" 에 대한 메모

1. API는 영원하다!

2. 하위 호환성을 지켜주세요.

3. 고객 사용 사례에서 거꾸로 만드세요.

4. 오류가 명시적인 API를 만드세요.

5. 바로 목적과 사용법을 이해할 수 있는 API를 만드세요.

6. 구현 세부 정보는 누출되지 않게 신경을 쓰세요.

- 초기 API 설계에서 실수하는 것

- Smithy를 통한 확장성 높은 API 만들기

## Comments



### Comment 8657

- Author: xguru
- Created: 2022-01-30T10:27:52+09:00
- Points: 2

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

### Comment 8619

- Author: edunga1
- Created: 2022-01-26T18:13:53+09:00
- Points: 3

저는 5번이 와닿았습니다.

참조되어 있는 "그런 REST API로 괜찮은가"는 전에 본적이 있는데 좋았어요: https://tv.naver.com/v/2292653

이런 시멘틱? 정보는 신경쓰지 않는데, Github API를 보면 이런 정보도 잘 내려주고 있어서 잘 만들었다는 느낌이 듭니다.

### Comment 8613

- Author: ehlegeth
- Created: 2022-01-26T10:53:22+09:00
- Points: 2

좋은 내용인 것 같습니다.

특히 1, 4번은 리뷰를 할 때 항상 얘기하게 되는 항목인 것 같네요.

3번은 Joshua Bloch가 얘기했던 "Write to Your API Early and Often"와 닿아있는 부분인 것 같습니다. (https://www.youtube.com/watch?v=aAb7hSCtvGw)

### Comment 8610

- Author: nicewook
- Created: 2022-01-26T10:16:03+09:00
- Points: 2

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