HTTP 어댑터

HTTP 어댑터는 HTTP 프로토콜 기반의 통신을 담당하는 최상위 컴포넌트입니다.

어댑터 생성

HTTP 어댑터의 생성 방법 및 설정 항목에 대해서는 어댑터 생성을 참고합니다.

엔드포인트 그룹 생성

HTTP 엔드포인트 그룹은 여러 HTTP 엔드포인트를 하나의 그룹으로 묶어 관리할 수 있게 해줍니다.

HTTP 엔드포인트 그룹의 생성 방법 및 설정 항목은 엔드포인트 그룹 생성을 참고합니다.

엔드포인트 생성

HTTP 엔드포인트는 HTTP 프로토콜 기반의 통신을 처리하는 최종 컴포넌트입니다.

HTTP 기반의 통신을 지원하며, HTTP 메서드(GET, POST 등)를 통해 다양한 요청을 처리할 수 있습니다. 인바운드 방식과 아웃바운드 방식을 모두 지원합니다.

다음은 HTTP 엔드포인트 생성 화면입니다. HTTP 엔드포인트 생성 화면으로 이동하는 방법은 엔드포인트 생성을 참고합니다.

http ep inbound form

기본 설정

다음은 HTTP 엔드포인트의 기본 설정 항목입니다. (*: 필수 설정 항목)

항목 설명

엔드포인트 아이디 *

엔드포인트의 고유 식별자입니다. 영문, 숫자, 언더스코어(_)를 조합하여 2~32자 이내로 입력합니다.

엔드포인트 이름

엔드포인트의 표시 이름을 입력합니다. 미입력 시 아이디 값으로 자동 설정됩니다.

통신 방향 *

엔드포인트의 통신 방향을 설정합니다.

  • Inbound: 외부로부터 메시지를 수신하기 위한 엔드포인트입니다.

  • Outbound: 외부로 메시지를 전송하기 위한 엔드포인트입니다.

부팅 초기값 *

엔드포인트의 초기 실행 상태를 지정합니다.

  • 실행: 엔진 시작 시 엔드포인트가 자동으로 시작됩니다.

  • 정지: 엔진 시작 시 엔드포인트가 시작되지 않습니다.

설명

엔드포인트에 대한 설명을 입력합니다.

연결 정보 설정

[연결 정보] 탭에서 HTTP 엔드포인트의 연결 방식을 설정합니다.

다음은 인바운드 엔드포인트의 설정 항목에 대한 설명입니다.

http inbound ep connection info
항목 설명

경로 *

요청을 수신할 URL 경로를 지정합니다. (예: /api/v1/messages)

기본 인코딩

인코딩 타입을 지정합니다.

  • EUC_KR

  • UTF8

메서드 타입

수신할 HTTP 요청의 메서드를 지정합니다.

  • GET: 리소스 조회

  • POST: 리소스 생성

  • PUT: 리소스 전체 수정

  • DELETE: 리소스 삭제

Post URL 디코딩 사용

POST 요청의 application/x-www-form-urlencoded 형식 데이터에 포함된 URL 인코딩 문자열(%20, %2F 등)을 실제 문자로 변환할지 여부를 설정합니다.

다음은 아웃바운드 엔드포인트의 설정 항목에 대한 설명입니다.

http outbound ep connection info
항목 설명

기본 인코딩

인코딩 타입을 지정합니다.

  • EUC_KR

  • UTF8

연결 타임아웃

연결을 시도할 때 최대 대기 시간을 설정합니다. (단위: ms)

소켓 타임아웃

데이터 송수신 시 최대 대기 시간을 설정합니다. (단위: ms)

URL *

요청을 전송할 대상 URL을 지정합니다. (예: http://example.com/api)

상세 설정

[상세 설정] 탭은 인바운드 엔드포인트 설정 시에만 표시됩니다.

항목 설명

거래 설정

엔드포인트에서 수신한 요청을 수행할 거래그룹 또는 거래를 선택합니다.

사용 예시

HTTP API 요청 수신 (Inbound)

외부 클라이언트로부터 HTTP API 요청을 수신하는 HTTP 인바운드 엔드포인트 설정 예시입니다.

시나리오
외부 클라이언트 → AnyLink (HTTP 서버) → 내부 처리

엔드포인트 설정 예시입니다.

항목 설정값

통신 방향

Inbound

부팅 초기값

실행

경로

/api/v1/orders

메서드

POST

Post URL 디코딩 사용

사용 안 함

요청 예시입니다.

curl -X POST http://localhost:8080/api/v1/orders \
  -H "Content-Type: application/json" \
  -d '{"orderId": "ORD001", "amount": 10000}'

외부 API 호출 (Outbound)

외부 HTTP API를 호출하는 HTTP 아웃바운드 엔드포인트 설정 예시입니다.

시나리오
AnyLink → 외부 HTTP API 서버

엔드포인트 설정 예시입니다.

항목 설정값

통신 방향

Outbound

부팅 초기값

실행

URL

http://api.example.com/v1/payments

연결 타임아웃

5000 ms

소켓 타임아웃

30000 ms

타임아웃 설정은 대상 서버의 응답 시간을 고려하여 설정합니다. 너무 짧게 설정하면 정상 요청도 타임아웃될 수 있습니다.