TOPIC ARCHIVE

외부 API·시스템 연계

외부 시스템의 요청·응답 형식, 실패 처리, 전환과 롤백 방법을 다룬 기록입니다.

CURATED NOTES

외부 API·시스템 연계

각 글은 하나의 대표 주제에만 분류했습니다. 시리즈가 있는 글에서는 구현 순서와 앞뒤 글도 함께 확인할 수 있습니다.

외부 API·시스템 연계 · 6개 글 · 작성일 최신순

외부 API·시스템 연계프로젝트 2026.03 — 2026.06 · 11분조회 집계 중

Commercial Invoice를 먼저 올려 FedEx ETD 운송장 만들기

상업송장을 먼저 업로드해 documentId를 받은 뒤 운송장 요청에 연결했습니다. OAuth 토큰 캐시와 법인별 계정·ETD 설정을 나눈 실제 Java 코드를 설명합니다.

FedEx APIOAuthETDREST API
외부 API·시스템 연계프로젝트 2023.09 — 2023.12 · 6분조회 집계 중

QAS에서 호출할 수 없던 Outsourcing API를 완료 범위에서 분리하기

본사·유럽의 COMS와 LIMS 네 시스템에서 통관정보가 오가는 것을 검증했습니다. QAS에서 호출할 수 없던 Outsourcing API는 구현 사실과 통합테스트 완료를 구분해 기록했습니다.

Integration TestQASREST APIData Flow
외부 API·시스템 연계프로젝트 2026.04 — 2026.05 · 7분조회 집계 중

실패했는데 HTTP 200을 반환하면 안 되는 이유

Well 좌표 충돌로 서버 처리가 실패했는데도 HTTP 200과 빈 본문이 반환됐습니다. 예외가 응답으로 바뀌는 경로를 추적해 비2xx 상태와 `errorCode`·`errorMessage`를 담은 오류 응답으로 바로잡은 사례입니다.

REST APIHTTP StatusError ContractSpring Boot
외부 API·시스템 연계프로젝트 2025.06 — 2025.11 · 7분조회 집계 중

반응마다 JVM을 종료하면 Connection Pool을 재사용할 수 없습니다

Spring Boot·MyBatis 커넥션 풀·직접 JDBC를 같은 조건에서 구현해 반복 비용을 비교했습니다. 반응마다 JVM이 종료되는 문제를 확인하고 연계를 상시 기동 REST API로 바꿨습니다.

JavaHikariCPREST APIProcess Lifecycle
외부 API·시스템 연계프로젝트 2026.03 — 2026.05 · 8분조회 집계 중

FedEx REST 배포를 백업 WAR로 복구하고 재전환한 과정

FedEx SOAP→REST 배포에서 운영 계정 연결 누락이 드러났습니다. 백업 WAR로 운송장 발급을 복구한 뒤 법인별 인증과 ETD 정책을 고쳐 재전환했습니다.

REST APIOAuthMigrationRollback