Repository navigation
Replies: 5 comments
1. 멱등성이란 무엇이며, 같은 API를 두 번 호출했을 때 어떤 조건을 만족해야 멱등하다고 할 수 있나요?멱등성(Idempotency)은 같은 요청을 여러 번 실행해도 서버에 남는 결과가 한 번 실행했을 때와 같은 성질이다. 같은 API를 두 번 호출했을 때 두 번째 호출이 상태를 더 바꾸지 않아야 멱등하다고 할 수 있다. 예를 들어 즉, 멱등성은 응답이 아니라 서버 상태를 기준으로 판단한다. 또한 같은 클라리언트가 같은 요청을 반복한 경우만 따진다. 두 호출 사이에 다른 사용자가 데이터를 바꿔 결과가 달라졌다면, 그건 멱등성 위반이 아니다. 멱등성이 중요한 이유는 네트워크 타임아웃 때문이다. 타임아웃이 나면 클라이언트는 요청이 서버에서 처리됐는지 알 수 없다. 이때 멱등한 API는 안심하고 재시도할 수 있다. 반면 멱등하지 않은 API를 재시도하면 중복 결제 같은 문제가 생길 수 있다. 그래서 결제나 주문 API는 보통 클라이언트가 만든 고유 요청 ID인 2. HTTP 메서드인 GET, POST, PUT, DELETE, PATCH 중 어떤 것이 멱등하고 어떤 것이 그렇지 않은가요? 그 이유도 설명해주세요.HTTP에서 멱등성은 같은 요청을 여러 번 보냈을 때 서버에 남는 의도된 결과가 한 번 보냈을 때와 같은 지를 뜻한다.
이는 메서드의 기본 의미에 따른 분류이다. API 설계에 따라 3. 결제 API에서 클라이언트가 요청을 보냈는데, 네트워크 타임아웃으로 응답을 받지 못했습니다. 이때 클라이언트가 재시도하면 어떤 문제가 생길 수 있고, 멱등성을 통해 이 문제를 어떻게 해결하나요?타임아웃이 나도 결제가 실패했다고 단정할 수 는 없다. 서버가 결제를 완료했지만 응답만 클라이언트에 도착하지 않았을 수 있다. 이때 클라이언트가 새 결제 요청으로 재시도하면 이중 결제가 발생할 수 있다. 이를 막으려면 클라이언트가 하나의 결제 시도에 멱등성 키를 부여하고, 재시도할 때도 이와 같은 키를 보내야 한다. 서버는 그 키로 이미 처리한 요청인지 확인해 결제를 다시 실행하지 않고 기존 결과를 반환한다. 같은 키에 다른 결제 내용을 보냈다면 오류로 처리해야 한다. 핵심은 재시도가 새 결제가 아니라, 결과를 확인하려는 같은 요청임을 서버가 알아볼 수 있게 하는 것이다. |
1. 멱등성이란 무엇이며, 같은 API를 두 번 호출했을 때 어떤 조건을 만족해야 멱등하다고 할 수 있나요?멱등성(Idempotency)이란 같은 요청을 한 번 보내든 여러 번 보내든 서버의 최종 상태가 동일한 성질을 의미합니다. 예를 들어 사용자의 이름을 특정 값으로 변경하는 요청은 여러 번 실행해도 결과가 같으므로 멱등합니다. 반면 잔액에 일정 금액을 추가하는 요청은 호출할 때마다 결과가 달라지므로 멱등하지 않습니다. 멱등성을 만족하려면 같은 요청을 여러 번 실행했을 때 다음 조건을 만족해야 합니다.
이때 응답 코드까지 항상 같을 필요는 없고, 서버의 최종 상태가 같아야 한다는 점이 중요합니다. 2. HTTP 메서드인 GET, POST, PUT, DELETE, PATCH 중 어떤 것이 멱등하고 어떤 것이 그렇지 않은가요? 그 이유도 설명해주세요.
3. 결제 API에서 클라이언트가 요청을 보냈는데, 네트워크 타임아웃으로 응답을 받지 못했습니다. 이때 클라이언트가 재시도하면 어떤 문제가 생길 수 있고, 멱등성을 통해 이 문제를 어떻게 해결하나요?결제 요청이 서버에서 정상 처리됐지만 네트워크 문제로 응답만 유실될 수 있습니다. 이때 클라이언트가 실패했다고 판단해 다시 요청하면 같은 주문이 두 번 결제되는 문제가 발생할 수 있습니다. |
1. 멱등성이란 무엇이며, 같은 API를 두 번 호출했을 때 어떤 조건을 만족해야 멱등하다고 할 수 있나요?멱등성은 같은 요청을 한번 보내든 여러 번 보내든 결과가 똑같은 성질이다. 쉽게 설명하자면, 엘리베이터 호출 버튼이 멱등한 동작이다. 반대로 자판기에 돈을 넣고 버튼을 누르는 것은 멱등하지 않다. api에 적용하면, 같은 api를 두번 호출했을 때 서버의 상태가 한번 호출했을 때와 같으면 멱등하다고 한다. 응답 말고 서버의 상태가 같아야 한다!! 예를 들어 어떤 게시글을 삭제하는 요청을 두번 보내면, 첫번째는 ‘삭제 성공’ 응답을 받고 두번째는 ‘이미 없음’응답을 받을 수 있다. 응답은 다르지만, 결과적으로 게시글이 삭제된 상태라는 건 똑같다. 그래서 이 예시는 멱등하다. 2. HTTP 메서드인 GET, POST, PUT, DELETE, PATCH 중 어떤 것이 멱등하고 어떤 것이 그렇지 않은가요? 그 이유도 설명해주세요.일단 정리하자면, GET,PUT,DELETE는 멱등하고, POST는 멱등하지 않다. PATCH는 멱등하다고 보장되지 않는다. GET은 데이터를 조회만 하고 서버의 상태를 바꾸진 않는다. 몇번을 조회해도 서버에는 아무 변화가 없으니 멱등하다. 참고로 GET처럼 서버 상태를 아예 안 바꾸는 메서드는 안전한 메서드라고 부른다. PUT은 리소스를 보낸 내용으로 통째로 교체한다. 같은 요청을 보내면 같은 값으로 덮어쓰니 이것도 멱등하다. DELETE는 한번 지우면 없어지고, 또 지우려고 해도 여전히 없는 상태이기 때문에 응답은 달라질 수 있어도 서버상태는 같으니 멱등하다. POST는 새 리소스를 만드는데, 예를 들어 “주문 요청”이라는 요청을 두번 보내면 주문이 두개 생긴다. 호출할 때마다 서버 상태가 바뀌니까 멱등하지 않다. PATCH는 어떻게 쓰냐에 따라 다른데, 같은 변경 요청을 여러번 보내도 결과가 같은 요청도 있고, 다른 요청도 있다. 그래서 PATCH는 멱등성이 보장되지 않는 메서드로 분류한다. 3. 결제 API에서 클라이언트가 요청을 보냈는데, 네트워크 타임아웃으로 응답을 받지 못했습니다. 이때 클라이언트가 재시도하면 어떤 문제가 생길 수 있고, 멱등성을 통해 이 문제를 어떻게 해결하나요?결제는 보통 POST라서 멱등하지 않다. 결제 요청을 보냈을 때 타임아웃이 나는 상황은 두가지가 있다. 하나는 결제요청도 실패해서 결제가 아예 이뤄지지 않은 경우이고 또 하나는 결제 요청을 보내는 건 성공해서 결제를 다 처리했는데, 돌아오는 응답만 안 온 경우이다. 이때 클라이언트가 실패한 줄 알고 결제를 재시도 하면 이중 결제가 이뤄진다. 이 경우엔 위험하다. 이런 문제를 해결하는 방법은 멱등성 키를 사용하는 것이다. 결제 요청 하나에 고유한 이름표를 붙이는 방식이다. 먼저 클라이언트가 결제를 시작할 때 UUID같은 고유한 키를 하나 만들고, 요청 헤더에 키를 담아 보낸다. 서버는 요청을 받으면 이 키를 처음 보는지 확인한다. 처음 보는 키라면 결제를 처리하고 키와 처리결과를 db에 저장해둔다. 이렇게 하면 아까처럼 결제요청이 서버에 도달해서 성공했는데 응답이 안 온 경우에 생기는 이중 결제 문제를 해결할 수 있다. 이미 본 키라면 요청을 처리하지 않게 하여 POST결제 요청을 멱등하게 만든 것이다. 실무에서는 요청 두개가 같은 키로 거의 동시에 들어오는 경우도 고려해야 한다. 그래서 키를 저장할 때 DB의 유니크 제약 조건이나 락을 걸어서, 하나만 처리되고 나머지는 “처리 중”이라고 응답하게 만든다. |
1. 멱등성이란 무엇이며, 같은 API를 두 번 호출했을 때 어떤 조건을 만족해야 멱등하다고 할 수 있나요?멱등성은 같은 요청을 여러 번 보내도, 서버에 의도한 변화가 한 번 보냈을 때와 같은 성질이다. 예를 들어 회원의 이름을 '김철수'로 바꾸는 요청은 여러 번 보내도 이름이 '김철수'로 유지된다. 반대로 포인트를 100점 추가하는 요청은 보낼 때마다 포인트가 늘어나므로 멱등하지 않다. 여기서 응답 내용까지 매번 같아야 하는 것은 아니다. 중요한 것은 같은 요청을 반복했을 때 같은 작업이 중복으로 적용되는지이다. 예를 들어 삭제 요청은 처음에는 삭제에 성공하고, 두 번째에는 이미 없다는 응답이 올 수 있다. 응답은 다르지만 해당 데이터가 삭제된 상태는 같으므로 멱등하다고 볼 수 있다. 2. HTTP 메서드인 GET, POST, PUT, DELETE, PATCH 중 어떤 것이 멱등하고 어떤 것이 그렇지 않은가요? 그 이유도 설명해주세요.GET, PUT, DELETE는 HTTP에서 멱등한 메서드로 정의되어 있다. GET은 데이터를 조회하는 요청이므로 반복해서 보내도 그 데이터 자체를 바꾸지 않는다. PUT은 지정한 데이터의 전체 내용을 요청한 값으로 바꾸는 방식이다. 같은 내용을 여러 번 보내도 최종적으로 저장된 내용은 같다. DELETE는 지정한 데이터를 삭제하므로 여러 번 보내도 해당 데이터가 없는 상태가 된다. POST와 PATCH는 멱등성이 보장되지 않는다. POST로 주문을 생성하면 같은 요청을 두 번 보냈을 때 주문이 두 개 만들어질 수 있다. PATCH는 데이터의 일부를 수정하는 요청인데, 어떤 수정을 하는지에 따라 달라진다. 이름을 '김철수'로 바꾸는 작업은 반복해도 같지만, 포인트를 100점 올리는 작업은 반복할수록 값이 달라진다(일부만 수정한다고 해서 무조건 멱등한 것은 아님). 다만 메서드 이름만 맞게 사용한다고 멱등성이 자동으로 생기는 것은 아니다. 서버에서도 그 의미에 맞게 구현해야 한다. 반대로 POST도 중복 요청을 막는 처리를 추가하면 멱등하게 동작하도록 만들 수 있다. 3. 결제 API에서 클라이언트가 요청을 보냈는데, 네트워크 타임아웃으로 응답을 받지 못했습니다. 이때 클라이언트가 재시도하면 어떤 문제가 생길 수 있고, 멱등성을 통해 이 문제를 어떻게 해결하나요?타임아웃이 발생했다고 해서 결제까지 실패했다고 볼 수는 없다. 서버에서는 결제가 완료됐는데 응답만 클라이언트에 도착하지 못했을 수도 있다. 이 상태에서 다시 요청을 보내면 서버가 새로운 결제로 처리해 같은 주문에 대해 두 번 결제할 수 있다. 이를 막기 위해 결제 요청에 멱등성 키라는 고유한 값을 함께 보낼 수 있다. 하나의 결제 작업에 키 하나를 정하고, 응답을 받지 못해 재시도할 때도 같은 키를 사용하는 것이다. 서버는 이 키와 처리 결과를 저장해 두고, 이미 완료된 키가 다시 오면 결제를 새로 하지 않고 기존 결과를 돌려준다(재시도할 때마다 새 키를 만들면 같은 결제인지 알 수 없으므로 중복 방지가 안 됨). 예를 들어 키가 'payment-123'인 요청으로 결제가 완료됐다면, 같은 키로 다시 요청해도 결제는 한 번만 이루어진다. 아직 처리 중이라면 완료된 결과를 확인하도록 안내할 수 있다. 같은 키의 요청이 동시에 들어와도 한 번만 처리되도록 해야 하고, 같은 키로 결제 금액 등 다른 내용을 보내면 그대로 재사용하지 않고 오류로 처리해야 한다. 결국 응답을 못 받아 다시 요청하더라도 실제 결제는 중복되지 않도록 만드는 것이다. |
1. 멱등성이란 무엇이며, 같은 API를 두 번 호출했을 때 어떤 조건을 만족해야 멱등하다고 할 수 있나요?같은 요청을 서버에 보낼때 한번이나 여러번 보낼때 서버의 최종 상태가 같으면 멱등이라고 한다 HTTP 명세에도 같은 요청을 여러번 보냈을때 서버에 의도한 효과가 한번 보낸것과 같으면 멱등하다고 정의한다. 같은 API를 두번 보내면 서버 상태에 따라 DELETE/users/1을 두번 보내면 처음에는 200, 두번째는 404가 오지만 1번 유저가 없다는 최종 상태가 같으니까 멱등하다고 할 수 있다 2. HTTP 메서드인 GET, POST, PUT, DELETE, PATCH 중 어떤 것이 멱등하고 어떤 것이 그렇지 않은가요? 그 이유도 설명해주세요.→ GET: 리소스를 조회하고 상태를 바꾸지 않는다. 다른 요청 때문에 데이터가 바뀌면 응답은 달라지지만 GET자체가 상태를 바꾸진 않기에 안전하고 멱등성이 있다 POST: 서버가 새 리소스를 만들고 URL도 서버가 정한다 POST/orders를 두번 보내면 id가 다른 주문 두개가 생긴다. 리소스 생성 이외에도 어떤 처리에 대한 실행을 명령하기에 호출 할때 효과가 생긴다 DELETE: 처음 호출하면 리소스가 지워지고 이후에는 없는 상태가 유지된다 DELETE/posts/latest 처럼 설계할 경우 호출 할때마다 다른 글이 지워져 멱등성이 깨진다. 그래서 대상을 정확하게 가리키는 URL로 설계해야한다. PUT: 클라이언트가 지정한 URL의 리소스를 요청 본문으로 대체한다. 리소스가 없는 경우 새로 만든다 요청을 몇번을 보내도 유저의 상태가 똑같고. PUT을 처리하며 방문횟수가 증가하는 방식으로 구현하면 멱등성이 깨지고 명세를 어긴다. PATCH: 리소스의 일부분만 수정한다 명세도 PATCH를 멱등하다고 정의하지 않지만 요청본문이 어떤값으로 바꾸는지가 아닌 어떻게 바꿀지를 담을 수 있기때문이다 PATCH는 멱등하다고 가정하면 안되고 멱등하게 하려면 조건부 요청을 쓰면된다. (If-Match: “eta값”) 리소스가 이미 바뀌었다면 거절된다 3. 결제 API에서 클라이언트가 요청을 보냈는데, 네트워크 타임아웃으로 응답을 받지 못했습니다. 이때 클라이언트가 재시도하면 어떤 문제가 생길 수 있고, 멱등성을 통해 이 문제를 어떻게 해결하나요?→ 타임아웃의 문제에서 1) 요청이 서버에 도착하지 못했거나 2) 서버가 처리하다가 실패하거나 3)서버가 결제를 처리했는데 응답이 사라진 문제 등을 클라이언트가 구분할 수 없다 재시도 하지 않으면 1, 2 에서 결제가 누락된다 3의 경우 이중결제가 이루어진다. 사용자가 결제버튼을 계속 누르거나 모바일에서 와이파이와 LTE가 바뀌는 순간에도 문제가 생긴다. POST는 원래 멱등하지 않기에 이런일이 일어난다 해결방법: 멱등성키를 이용 서버에게 요청을 이미 처리한 요청이라는걸 알게해 고유한 키를 붙이는 방식이다 클라이언트는 결제 시도마다 키를 만들고 서버는 키의 상태에 따라 처음보는키, 완료키, 처리중키, 같은 키인데 요청이 다른상태에 대한 처리를 각각 다르게 정한다 |
Uh oh!
There was an error while loading. Please reload this page.
📆 일자: 26년 9월 27일(일)
발제 의도
🤔 오늘의 질문
멱등성이란 무엇이며, 같은 API를 두 번 호출했을 때 어떤 조건을 만족해야 멱등하다고 할 수 있나요?
HTTP 메서드인 GET, POST, PUT, DELETE, PATCH 중 어떤 것이 멱등하고 어떤 것이 그렇지 않은가요? 그 이유도 설명해주세요.
결제 API에서 클라이언트가 요청을 보냈는데, 네트워크 타임아웃으로 응답을 받지 못했습니다. 이때 클라이언트가 재시도하면 어떤 문제가 생길 수 있고, 멱등성을 통해 이 문제를 어떻게 해결하나요?
All reactions