일일 업무 보고서 (Daily Report)

수신: (주)뷰티인사이드랩 박용락 PM AI서비스팀
날짜: 2026년 01월 02일
작성: Antigravity (AI Agent)

📌 업무 요약

금일 관세청 수출입 무역 통계 API 연동 과정에서 발생한 데이터 조회 실패 및 시뮬레이션 모드 전환 문제를 집중적으로 디버깅하고 해결하였습니다. 현재 API는 정상적으로 실시간 데이터를 수신하고 있습니다.

🛠 주요 해결 이슈 및 조치 사항

1. API 클라이언트 함수 미정의 오류 수정

• 증상: 'fetchFromKoreaCustoms' names not found 에러 발생.
• 원인: 호출하려는 함수명이 실제 정의된 함수명(fetchFromProxy)과 불일치.
• 조치: 올바른 함수명으로 호출 코드를 수정하여 기본 실행 흐름 복구.

2. API 엔드포인트 및 파라미터 최신화

• 증상: 필수 파라미터 누락 에러(Result Code 99) 및 404/500 에러.
• 원인: 구버전 API 주소(openapi.customs.go.kr) 및 파라미터(searchBgnDe) 사용.
• 조치: 공공데이터포털 최신 명세에 따라 엔드포인트(apis.data.go.kr) 및 파라미터(strtYymm, endYymm) 변경 적용.

3. 인증키 인코딩 자동화 (401 Unauthorized)

• 증상: 유효한 Decoding 키를 입력했음에도 인증 실패 발생.
• 원인: Decoding 키가 URL 인코딩 없이 전송되어 서버에서 인식 불가.
• 조치: 입력된 키 타입을 감지하고 필요한 경우 자동으로 URL Encoding을 적용하는 스마트 로직 추가.

4. 날짜 범위 계산 오류 수정 (Timezone Issue)

• 증상: "조회 기간은 1년 이내여야 합니다" 에러 계속 발생.
• 원인: Date.toISOString() 사용 시 UTC 시간으로 변환되면서, 날짜가 하루 밀려 시작일이 전년도 12월로 계산됨 (총 13개월 조회 시도).
• 조치: 로컬 시간 기준으로 정확히 12개월(당해 1월 ~ 12월)을 계산하도록 로직 수정.

5. 응답 코드 유효성 검사 완화 (Fake 502)

• 증상: API가 정상 응답(resultCode: 0)을 보냈으나 502 에러 처리.
• 원인: 코드는 문자열 '00'만 성공으로 간주했으나, XML 파서가 숫자 0으로 변환.
• 조치: 숫자 0과 문자열 '00' 모두 성공으로 인정하도록 조건문 수정.

✅ 결과 및 향후 계획

• 결과: 관세청 API 실시간 연동 성공. SIMULATION 태그 사라짐 확인.
• 참고사항: Gemini API의 경우 Free Tier 사용량 제한(Quota Exceeded)으로 인해 간헐적 실패가 발생할 수 있으나, 이는 코드 오류가 아닌 플랜 제한임을 확인.

이상입니다.