인증·재시도·타임아웃
API 인증 방식과 안정적인 요청 설정
2 min read
많은 API 는 인증을 요구하고, 네트워크는 가끔 불안정합니다. Layerz 는 다양한 인증 방식과, 실패에 대비한 재시도·타임아웃 설정을 제공합니다.
인증 (Auth)
- None — 인증 없음
- Bearer Token — 토큰을 헤더에 담아 전송
- Basic — 사용자 이름·비밀번호 기반
- API Key — 키를 Header 또는 Query 에 담아 전송
- OAuth 2.0 — Client Credentials 방식. 받은 토큰은 메모리에 캐시됩니다.
인증값에도 바인딩 토큰을 사용할 수 있어, 토큰이나 키를 프로젝트 데이터에서 가져오게 할 수 있습니다.
재시도와 타임아웃
- Timeout — 요청이 이 시간을 넘기면 실패로 처리합니다.
- Max Retries — 실패 시 다시 시도할 최대 횟수
- Retry Delay — 재시도 간격 (지수 백오프로 점점 늘어남)
재시도는 타임아웃, 연결 오류, 그리고 408·429·5xx 응답에 대해 이루어집니다. 일시적인 네트워크 문제나 서버 혼잡 상황에서도 안정적으로 동작하게 해 줍니다.
공개 테스트 API 로 연습할 때는 인증이 None 인 경우가 많습니다. 실제 서비스 API 를 연결할 때 인증 방식과 재시도를 함께 설정하세요.