안녕하십니까 네이버 검색광고 API 담당자입니다.
지난 2020년 9월 10일 API 응답지연 장애( 하단 공지 참고) 이후 특정 기능에서 이전보다 더 많은 429 번 에러 즉 Too Many Request 가 발생하고 있어 추가 가이드를 공지 합니다.
최근 키워드도구 기능에서 더 자주 429 에러가 발생하는 원인 네이버 검색광고 API 서비스의 사용량 제한은 호출 대상 계정당 속도 제한으로서 전체 서비스 사용량에 따라 유연한 형태를 유지하여왔습니다.
한편 이러한 사용량 제한과는 별개로 서비스에 대한 공격 및 침탈 시도를 방지를 하기 위한 내부 보안 장치들 역시 존재하여 왔으며 이 장치들은 일상적인 사용자 분들의 서비스 이용에는 전혀 영향을 주지 않았었습니다. 그러나 지난 9월 10일 보안 장치들의 제한이나 로직등을 수정/강화하였고 이로 인하여 정상적인 이용임에도 영향을 받는 상황이 발생하게 되었습니다.
조치 사항
지난 9월 10일 조치 이후 몇달간 지속적인 모니터링 및 튜닝을 통해 이전과 동일한 서비스 상황으로 복귀하고자 노력하였으나 서비스 이용 패턴 등을 고려할때 이전과 동일하거나 유사한 서비스 환경으로의 복귀는 불가능하다는 결론에 도달하였으며 이에 따라 변화된 이용 가이드를 고지 드립니다.
대상 서비스
키워드 도구 서비스 (RelKwdStat) 아래 제한 사항 및 가이드는 키워드 도구 서비스에 한정된 사항입니다. 기존 서비스들은 변경이 없습니다. (대용량 다운로드 보고서 및 마스터 보고서의 호출 속도 제한이 상대적으로 느린 이유는 비동기 배치성 이라는 서비스 특성에 기인한 것으로 이번의 가이드와는 무관합니다.)
제한 사항
A. 다른 오퍼레이션 대비 호출 속도는 1/5~1/6 수준으로 제한됨. B. 속도 측정 단위에 호출 대상 커스터머 아이디외에 호출 클라이언트의 IP 정보도 포함되며 IP당 호출 속도는 다른 오퍼레이션 대비 약 1/2 정도 수준으로 제한됨.
사용 가이드
A. 키워드 도구 서비스 이용시 429번 에러가 리턴되면 타 서비스들에 비해 5~6배 정도 긴 시간 Sleep 후 호출 하십시오. B. 여러 커스터머 아이디에 대하여 동시에 호출 할 경우 적절히 장비를 분리하거나 네트웍을 분리하십시오. C. 극히 짧은 시간(수 초내외)동안 대량의 429 에러가 지속적으로 리턴되도록 로직을 구성하지 마십시오. 만일 테스트 등으로 인해 이러한 일을 발생하였다면 최소 5분 이상 모든 호출을 중단후 다시 재시도 하십시오.