Postman을 장기간 사용하여 "429 Too Many Requests" 오류를 경험한 적이 있습니까? 이 상태 코드는 귀하의 요청이 API의 비율 제한을 초과했음을 나타낼 수 있습니다.
Apidog에 대한 더 많은 세부 정보를 알고 싶다면 아래 버튼을 클릭하여 직접 사용해 보세요! 👇
Postman이란?
Postman은 개발자가 API를 구축, 테스트 및 문서화할 수 있도록 해주는 API 개발 플랫폼입니다. 다양한 기능 덕분에 Postman은 개발자들이 Postman 관련 문제를 해결하는 데 의존하는 가장 인기 있는 API 도구 중 하나로 빠르게 자리 잡았습니다.
Postman 429 Too Many Requests 오류란?
Postman 429 Too Many Requests 오류는 귀하가 Postman 자체 또는 상호작용 중인 API에서 설정한 비율 제한을 초과했다는 것을 나타냅니다. 이 오류 메시지는 본질적으로 서버가 과부하 상태이며 요청 빈도를 줄여야 함을 의미합니다.
Postman 429 Too Many Requests 메시지의 잠재적 원인
Postman의 비율 제한
- 무료 플랜 제한: Postman은 무료 플랜에 대한 비율 제한이 있습니다. 귀하는 일반적으로 60 rpm 기준으로 요청 수를 초과할 수 있습니다.
- 모의 서버 제한: Postman의 내장 모의 서버 또한 무료 및 유료 플랜에 대한 비율 제한이 있습니다. 특정 제한 사항은 귀하의 플랜을 확인하세요.
API 비율 제한
- 외부 API 제한: 테스트 중인 API에는 남용을 방지하기 위해 자체 비율 제한이 있을 수 있습니다. 이 제한은 API 공급자에 따라 달라질 수 있습니다.
우발적 속도 제한
- 빠른 스크립팅: Postman에서 테스트 자동화를 위해 스크립트를 사용하고 있다면 요청이 너무 빨리 전송되어 비율 제한을 초과할 수 있습니다.
더욱 진단하는 방법
- Postman 사용 통계: 최근 요청량을 확인하기 위해 Postman 사용 통계(앱 내에서 접근 가능)를 체크하세요.
- API 문서: 테스트 중인 API 문서를 참조하여 비율 제한 및 특정 값을 확인하세요.
Postman 429 Too Many Requests 오류 처리 방법
원인 이해하기
- Postman 비율 제한: Postman 자체의 비율 제한은 분당 300요청입니다. 이 제한을 초과하면 테스트를 재개하기 전에 잠시 기다리는 것을 고려하세요.
- API 비율 제한: 테스트 중인 특정 API는 자체 비율 제한이 있을 수 있습니다. 허용되는 요청 빈도에 대한 세부 정보는 API 문서를 확인하세요.
해결 방법
- 기다리기: 가장 간단한 해결책은 비율 제한이 리셋될 때까지 기다리는 것입니다. 이 시간은 제한의 출처(Postman 또는 API)에 따라 다릅니다.
- 요청 빈도 줄이기: 테스트 스크립트 또는 수동 테스트 속도를 조정하여 허용된 시간 내에 fewer 요청이 전송되도록 하세요.
- 배치 크기 증가 (해당되는 경우): 대량 데이터를 수용하는 엔드포인트를 테스트하는 경우, 여러 개의 작은 요청 대신 각 요청에서 더 큰 배치를 데이터로 보내는 것을 고려하세요. 이렇게 하면 필요한 총 요청 수를 줄일 수 있습니다.
- Postman 플랜 업그레이드 (해당되는 경우): 빈번한 Postman 사용자이고 지속적으로 비율 제한에 도달하는 경우, 더 높은 요청 한도를 제공할 수 있는 유료 플랜으로 업그레이드하는 것을 고려하세요.
- API 지침 준수: 일부 API는 요청 간의 특정 대기 시간을 제안할 수 있으며, 더 높은 한도를 위해 인증을 사용하도록 권장할 수 있습니다. API 문서에서 제공된 모든 지침을 준수하세요.
Apidog - 맞춤 API 응답 초기화
Apidog는 API를 더 쉽게 만들 수 있는 무료 플랫폼입니다. API를 설계하고 테스트하며 모든 것이 원활하게 작동하는지 확인하는 데 필요한 모든 기능을 갖추고 있습니다. API 문서 작성을 돕기까지 합니다. Apidog는 배우기 쉬워 초보자나 경험이 있는 개발자 모두에게 훌륭합니다 – 누구나 빠르게 API를 구축할 수 있습니다.
Apidog을 사용하여 API의 429 Too Many Requests 및 기타 보기
429 Bad Request 메시지는 API가 반환할 수 있는 여러 잠재적 결과 중 하나입니다. API에서 발생하는 상황에 대해 더 나은 맥락을 제공하기 위해, 429 Too Many Requests 외에도 어떤 다른 코드를 받을 수 있는지 보기 위해 가능한 모든 응답을 볼 수 있습니다.
먼저, 응답을 확인하고 싶은 API를 선택하세요. 위 그림에서는 선택한 API가 Find pet by ID입니다.
다음으로, 위 그림과 같이 Edit 헤더를 클릭하세요. 이제 Responses 섹션이 있을 때까지 아래로 스크롤하여 이 API에서 할당된 이름과 함께 다양한 API 응답 코드를 볼 수 있습니다.
위 그림에서 확인할 수 있는 API 응답 코드 예시로는 OK(200), Record not Found(404), Invalid input(400)가 있습니다. 이 예시에서는 코드 번호 400이 이름으로 Invalid input으로 대체되었습니다.
API 응답 코드는 선택된 HTTP 방법에 따라 다를 수 있습니다. 어떤 API 응답 코드를 사용할지에 대한 더 많은 이해를 원하시면 관련된 REST API 방법에 대한 기사를 확인해 보세요:
또한, 가져오기를 통해 해당 JSON 응답 코드를 자동으로 생성한다는 것을 깨달았을 수 있습니다. 맞습니다 - Apidog는 기존 코드 또는 파일 가져들에 근거하여 개발자가 정확하게 코드를 생성할 수 있도록 하는 내장 코드 생성 기능을 제공합니다. 이는 API 개발자가 더 짧은 시간 안에 더 높은 성공률로 API를 제작할 수 있게 해줍니다.
Apidog를 사용하여 API의 추가 응답 코드 생성하기
Apidog는 API에 대해 다양한 상황에 대처하는 추가 응답을 생성할 수 있게 해줍니다. 때때로 문제가 발생할 수 있으므로 Apidog는 오류가 발생한 쪽(클라이언트 또는 서버)을 지정하여 문제 해결을 용이하게 할 수 있도록 합니다.
오류가 클라이언트 또는 서버에서 발생했는지(유용한 API 응답 덕분에) 파악하는 것은 개발자가 문제를 더 빨리 찾아내는 데 도움이 됩니다. 누가 잘못했는지와는 관계없이 말이죠.
먼저, API 응답 코드 헤더와 동일한 행에 있는 + Add 버튼을 찾으세요.
이 예시에서 Add Blank Response를 선택하면 다음과 같은 팝업이 나타납니다:
이 단계에서는 응답 코드에 적절한 이름과 해당하는 HTTP 상태 코드를 제공해야 합니다. 위의 응답 코드 예시를 참조하세요. 응답 코드 이름과 상태 코드는 모두 직관적이어야 하므로 신중하게 선택하세요!
Apidog로 새 API 응답 코드 개인화하기
위 그림은 Created(201)이라는 새로운 API 응답을 보여줍니다. Apidog를 사용하면 사용자가 응답 코드 개발에서 어떻게 진행할지를 선택할 수 있는 자유가 있습니다.
결론
Postman에서 429 Too Many Requests 오류를 경험하는 것은 실망스러울 수 있지만, API 개발 중에 흔히 발생하는 장애물입니다. Postman 자체의 비율 제한 또는 테스트 중인 API의 제한 등 잠재적인 원인을 이해함으로써 문제를 효과적으로 진단할 수 있습니다.
좋은 소식은 해결 방법이 있다는 것입니다! Postman의 요청 속도를 조정하거나 비율 제한이 리셋될 때까지 기다리거나 (해당되는 경우) Postman 플랜을 업그레이드하면 다시 정상으로 돌아갈 수 있습니다. 외부 API 제한을 다루고 있다면 그들의 지원팀에 연락하여 안내를 요청하는 것을 고려하세요. 잘 설계된 API는 다양한 시나리오를 예측하고 유용한 오류 응답을 제공하는 것을 잊지 않도록 하세요. 이렇게 하면 문제의 원인을 찾아내는 과정이 더 빨라질 수 있으며, 클라이언트 애플리케이션이든 서버 자체이든 문제를 신속하게 파악할 수 있습니다. Postman의 기능을 활용하고 API 모범 사례를 이해함으로써 여러분의 개발 과정이 원활하게 진행되도록 할 수 있습니다.
