HTTP 요청
ssemworks-microservice-base.httpRequest통신/외부HTTP
임의의 HTTP/HTTPS API 를 호출한다. 인증·헤더·쿼리·본문·응답 형식을 지정할 수 있다.
기본 정보
| 항목 | 값 |
|---|---|
| 서비스 타입 | ssemworks-microservice-base.httpRequest |
| 표시 이름 | HTTP 요청 |
| 카테고리 | 통신/외부 |
| 그룹 | output |
| 버전 | 1 |
입출력
- 입력: 메인(main)
- 출력: 메인(main)
파라미터
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 메서드 | method | 선택 | GET | HTTP 메서드 선택지: GET · POST · PUT · DELETE · PATCH · HEAD · OPTIONS |
| URL | url | 문자열 | "" | 요청 대상 URL (표현식 사용 가능) |
| 인증 | authentication | 선택 | none | 인증 방식 선택지: 없음( none) · Basic(basicAuth) · Bearer(bearerAuth) · Digest(digestAuth) · OAuth2(oAuth2) · API Key(apiKey) |
| 헤더 | headers | 고정 컬렉션 | {} | — |
| 쿼리 파라미터 | queryParameters | 고정 컬렉션 | {} | — |
| 본문 형식 | bodyContentType | 선택 | none | 요청 본문 형식 선택지: 없음( none) · JSON(json) · multipart/form-data(multipartFormData) · form-urlencoded(formUrlEncoded) · Raw(raw) · 바이너리(binaryData) · GraphQL(graphql) |
| 본문(JSON/Raw) | body | JSON | {} | JSON 또는 Raw 본문 표시 조건: bodyContentType = "json" 또는 "raw" |
| Content-Type | contentType | 문자열 | text/plain | Raw 본문의 Content-Type 표시 조건: bodyContentType = "raw" |
| 본문 파라미터 | bodyParameters | 고정 컬렉션 | {} | 표시 조건: bodyContentType = "multipartFormData" 또는 "formUrlEncoded" |
| 응답 형식 | responseFormat | 선택 | auto | 응답 파싱 방식 선택지: 자동( auto) · JSON(json) · 문자열(string) · 파일(file) |
| 옵션 | options | 컬렉션 | {} | — |
헤더 하위 필드
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 이름 | name | 문자열 | "" | — |
| 값 | value | 문자열 | "" | — |
쿼리 파라미터 › 파라미터 하위 필드
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 이름 | name | 문자열 | "" | — |
| 값 | value | 문자열 | "" | — |
본문 파라미터 › 파라미터 하위 필드
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 이름 | name | 문자열 | "" | — |
| 값 | value | 문자열 | "" | — |
옵션 하위 필드
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 타임아웃(ms) | timeout | 숫자 | 10000 | 요청 타임아웃(밀리초) |
| 인증서 검증 무시 | allowUnauthorizedCerts | 불리언 | false | 자기서명 인증서 등 검증 실패를 무시할지 여부 |
| 상태 코드 검사 | responseCodeCheck | 불리언 | true | 성공 범위를 벗어난 응답을 오류로 처리할지 여부 |
| 성공 코드 시작 | responseCodeFrom | 숫자 | 200 | 성공으로 간주할 상태 코드 하한 |
| 성공 코드 끝 | responseCodeTo | 숫자 | 299 | 성공으로 간주할 상태 코드 상한 |