심화Rate Limit · 요청 제한
레이트 리밋
정해진 시간 안에 보낼 수 있는 요청 횟수의 상한이에요. 넘으면 잠시 막혀요.
한 줄 비유
놀이기구의 시간당 탑승 인원 제한이에요. 넘치면 '잠시 후 다시'하고 줄을 세워요.
바이브코딩에서 언제 만나나
잘 되다가 갑자기 'rate limit exceeded' 에러로 막힐 때 만나요.
앱이 잘 돌아가다가 갑자기 “rate limit exceeded” 같은 에러가 뜰 때가 있어요. 코드를 바꾼 것도 아닌데 말이죠. 당황스럽지만, 이건 고장이 아니라 규칙이에요.
레이트 리밋은 정해진 시간 안에 보낼 수 있는 요청 횟수의 상한이에요. 인기 놀이기구의 시간당 탑승 인원 제한과 같아요. 한꺼번에 너무 몰리면 안전을 위해 “잠시 후 다시” 하고 줄을 세우잖아요. 서비스도 서버를 지키려고, 짧은 시간에 요청이 몰리면 잠깐 막아요.
에러라기보다 ‘지금은 좀 천천히’라는 신호예요. 대개 잠시 기다리면 풀려요.
대처는 두 가지예요. 하나는 요청을 몰아치지 말고 간격을 두는 것, 또 하나는 무료 등급이라면 한도가 낮으니 사용량을 확인하는 거예요. 참고로 이 한도는 API 키 단위로 걸리는 경우가 많아요. 그래서 갑자기 막히면 “내가 지금 너무 빨리 부르고 있나?”부터 의심하면 대개 맞아요.
30초 확인 퀴즈
요청을 빠르게 여러 번 보내자 'rate limit' 에러가 났어요. 이유로 가장 알맞은 건?
레이트 리밋은 시간당 요청 횟수 제한이에요. 넘으면 잠깐 막히며, 잠시 기다리거나 요청 속도를 늦추면 풀려요.