학습 목표
- 외부 API 연결과 실패 처리의 역할과 적용 조건을 설명할 수 있다.
- 문서에서 인증·응답 예시·한도·과금·오류를 표로 정리하세요.
- 정상·401·429·500·잘못된 JSON을 구분해 표시하는지 확인하세요.
사전 지식
앞선 인증과 권한을 안전하게 나누기를 먼저 읽으면 용어를 이해하기 쉽습니다. 이미 아는 내용이면 이 장부터 시작해도 됩니다.
개념 이해
외부 API는 다른 서비스의 기능을 정해진 형식으로 빌려 쓰는 창구입니다. 성공 데이터뿐 아니라 사용 한도·시간 지연·응답 형식 변화·장애에도 화면이 동작하도록 설계해야 합니다.
문서·키·메서드
문서의 인증 헤더·권한·페이지네이션·필드 단위를 읽습니다. GET은 조회, POST는 생성·명령, PATCH는 일부 수정, DELETE는 삭제에 주로 사용합니다.
JSON 검증
응답 타입과 null 의미를 검사하고 가격·속도·날짜 단위를 확인합니다. 일부 페이지를 전체 결과처럼 표시하지 않습니다.
서버 측 호출·비용
비밀키가 필요한 요청은 서버에서만 보냅니다. 같은 데이터를 여러 방문자가 볼 때는 캐시로 호출 수를 줄이고 호출량과 비용 한도를 관찰합니다.
재시도·타임아웃·Rate Limit
대기 시간을 제한하고 재시도 가능한 오류만 지수적 대기와 횟수 제한으로 반복합니다. 429의 Retry-After를 존중하고 변경 요청은 중복 실행 위험을 검토합니다.
캐시와 외부 장애
오래된 데이터로 안전하게 안내할 수 있는지 판단합니다. 갱신 시각·만료 시각·오류 상태를 분리하고 비밀이 든 원본 오류를 사용자에게 보내지 않습니다.
실제 사용 사례
AI 순위는 서버가 전체 모델 목록을 수집해 6시간 저장합니다. 외부 장애 때 마지막 데이터를 보여주되 언제 수집했는지 표시합니다. 실제 과거 기록이 없으면 그래프를 지어내지 않습니다.
단계별 실습
실습은 운영 서비스가 아닌 별도 연습 프로젝트에서 진행하세요. 기존 파일이 있다면 변경 전 기록을 남깁니다.
- 문서에서 인증·응답 예시·한도·과금·오류를 표로 정리하세요.
- 고정된 외부 주소로 서버 요청을 만들고 환경변수에 키를 보관하세요.
- JSON 스키마·페이지네이션·null·단위를 확인하세요.
- 타임아웃·제한 재시도·캐시·장애 대체 동작을 연결하세요.
- 정상·401·429·500·잘못된 JSON을 구분해 표시하는지 확인하세요.
코드와 프롬프트
아래 요청에서 대괄호 부분을 내 프로젝트에 맞게 바꾼 뒤 AI 도구에 전달하세요.
[공식 API 문서]의 인증과 실제 응답부터 확인해줘. 서버 전용 키, 응답 검증, 페이지네이션, 타임아웃, 제한 재시도, 429 대기, 캐시와 장애 대체를 구현해줘. 미제공 필드는 생성하지 말고 호출량과 마지막 갱신 시각을 보여줘.자주 발생하는 문제와 해결
| 문제와 원인 | 해결 방법과 확인 기준 |
|---|---|
| 외부 주소를 사용자 입력으로 그대로 호출함 | 허용된 호스트·경로만 받도록 제한해 서버 내부 요청 악용을 막습니다. |
| 실패마다 즉시 반복 호출함 | 대기·횟수·동시 요청 제한을 둡니다. |
핵심 요약
- 외부 API를 신뢰 경계 밖의 입력으로 취급합니다.
- 비용과 장애를 데이터 설계에 포함합니다.
완료 확인
참고자료
확인 기준일: 2026-10-20. 요금·사용 한도·제품 기능·설정 경로는 변경될 수 있으므로 작업 직전 공식 문서와 설치 버전을 확인하세요.