API 연동과 운영 가이드

API 연동은 인증, 요청, 응답 검증, 재시도, 기록을 나누어 구현하면 문제를 찾기 쉽습니다. 호출 성공과 업무 처리 완료를 구분하는 것이 안정적인 자동화의 출발점입니다.

응답 코드에 따라 무엇을 하나요?

응답	기본 대응
200·201	응답 내용과 생성된 결과를 추가 검증
202	요청 접수 상태 확인. 처리가 끝났다는 뜻은 아님
401·403	인증, 권한, 사용 가능 API를 점검
429	서비스의 Retry-After와 호출 제한에 맞춰 대기
5xx·네트워크 시간 초과	중복 실행 가능성을 확인한 뒤 제한적으로 재시도

키와 토큰은 어디에 두나요?

비밀번호와 토큰은 소스 코드나 공개 저장소에 넣지 않습니다. 개발 환경에서는 환경변수 등을 사용하고, 운영 환경에서는 접근 제어와 비밀 관리 기능을 검토합니다. 외부 API 호출에 다시 써야 하는 키는 해시만 저장하면 복원할 수 없다는 점도 구분해야 합니다.

실전 가이드

• API 키의 해싱과 암호화 구분하기
• Google Sheets API 읽기와 쓰기
• OAuth 토큰 수명과 갱신 흐름
• 호출 한도와 대기 처리
• 403 오류의 권한과 정책 확인

실패 로그에 남길 정보

실행 시각, 작업 식별자, 응답 코드, 재시도 횟수와 결과를 기록합니다. 인증 헤더와 개인정보는 로그에서 제외하세요. 요청을 재시도할 때는 같은 작업이 두 번 생성되지 않는지 확인하고 서비스가 제공하는 멱등성 키나 조회 API를 활용합니다.

업무 자동화 가이드에서 예약 실행과 프로그램 배포 과정을 이어갈 수 있습니다.