제공자 포털

활용 팁

디지털융합플랫폼의 중요한 업데이트와 새로운 소식을 확인할 수 있는 공간입니다.

상세보기

활용 팁

[활용 팁] Open API 호출 오류 시

작성자 : 운영자 작성일 : 2026-08-27

디지털융합플랫폼 OpenAPI 호출 오류 발생 시 확인사항 안내. 활용팁 1. 주요 오류 코드별 확인사항: AGW-E40401(미등록 API 또는 불일치)은 호출한 API URL 및 Method가 올바른지 확인, AGW-E40402(유효하지 않은 이용자 서비스 키)는 사용자 서비스 키(api_user_key_id)값이 호출 헤더값에 정상적으로 설정되었는지 확인하며 api_user_key_id는 반드시 HTTP Header를 통해서 전달 필요, AGW-E40303(요청한 API에 대한 권한 없음)은 호출한 API가 디지털융합플랫폼에서 사용신청한 항목인지 확인. 사용자 서비스 키(api_user_key_id)는 My Portal 메뉴의 나의 정보에서 확인 가능. 활용팁 2. 파라미터 미입력 발생 오류: OpenAPI별 필수 파라미터 미입력으로 발생하는 오류는 연계 기관의 응답전문을 그대로 전달하여 API별로 응답 및 오류 형태에 차이가 있으며, 필수 파라미터값을 꼭 입력해야 정상적으로 응답이 이뤄짐. 요청변수 표에서 필수구분이 Y인 경우 필수 항목임을 안내. 활용팁 3. OpenAPI 오류코드 정보: AGW-E40001 요청 전문/규격 이상, AGW-E40102 유효하지 않은 이용자 서비스 키, AGW-E40301 올바르지 않은 경로에서의 요청, AGW-E40303 요청한 API에 대한 권한 없음, AGW-E40302 일시적으로 사용자 요청 제한, AGW-E40401 미등록 API 또는 불일치, AGW-E415 지원하지 않는 미디어 유형, AGW-E41301 요청 전문 메시지 크기 초과, AGW-E41302 응답 전문 메시지 크기 초과, AGW-E42901 요청 한도 초과 제한. 하단에 서비스 문의 안내: 문의접수는 알림소통 메뉴의 서비스문의, 문의전화 070-8808-0344, 문의메일 support@koreaconnect.kr, 운영시간 평일 09시부터 18시까지(토, 일, 공휴일 휴무)를 소개하는 이미지