속성
| Name | Type | Description |
|---|---|---|
| Url | string | 리소스 URL입니다. |
| Method | string | 요청 유형입니다(예: GET 또는 POST). |
| AuthToken | string | 인증 토큰입니다(외부 서비스 인증이 필요한 경우). |
| AuthScheme | string | 인증 방식입니다. |
| ThrowExceptionOnFailed | boolean | 외부 서비스가 HTTP 응답 상태로 오류 코드를 반환할 때 예외를 생성해야 하는지 여부를 지정합니다. False로 설정하면 예외가 생성되지 않고, HTTP 상태 코드는 Status 속성에 저장됩니다. 기본값은 True입니다. |
| Timeout | number | 응답 제한 시간(분)입니다. 기본값은 1분입니다. 중요! 요청 제한 시간 값은 스크립트 실행 시간 제한(600초)을 초과할 수 없습니다. |
| ResponseText | string, 읽기 전용 | 텍스트 형식의 응답 결과입니다. |
| ResponseType | string, 읽기 전용 | 서비스에서 반환하는 요청 응답의 유형입니다(예: “application/json”). |
| Status | number | 외부 서비스의 HTTP 응답 상태 코드입니다. ThrowExceptionOnFailed가 True로 설정된 경우, 오류 코드는 예외를 발생시키며 트랜잭션이 중단됩니다. 오류 메시지 텍스트는 Skill Monitor에서 확인할 수 있습니다. |
Methods
| Name | Description |
|---|---|
| AppendStringContent(string data, string contentName); | multipart/form-data 형식의 string을 요청 본문에 추가합니다(기본적으로 콘텐츠 유형은 UTF-8 인코딩의 application/json으로 설정됩니다). contentName Parameter는 전달되는 형식에서의 field 이름을 지정합니다. |
| AppendStringContent(string data, string contentName, ContentEncoding contentEncoding, string mediaType?); | multipart/form-data 형식의 string을 요청 본문에 추가합니다. 추가로 인코딩을 지정할 수 있습니다. 콘텐츠 유형을 지정하지 않으면 기본값으로 “application/json”이 설정됩니다. |
| AppendFileContent(DocumentExportResult documentExportResult, string contentName, string mediaType?); | multipart/form-data 바이너리 데이터를 요청 본문에 추가합니다. 콘텐츠 유형은 전달되는 파일의 확장자를 기준으로 자동으로 설정됩니다. 필요한 경우 mediaType 선택적 Parameter를 사용하여 콘텐츠 유형을 미리 설정할 수 있습니다. |
| AppendFileContent(BinaryFile binaryFile, string contentName, string mediaType?); | 다음 바이너리 데이터를 요청 본문에 추가합니다: 트랜잭션에 가져온 원본 이미지 또는 Picture 형식의 field에 포함된 이미지. 콘텐츠 유형은 가져오는 파일의 확장자를 기준으로 자동으로 설정됩니다. 필요한 경우 mediaType 선택적 Parameter를 사용하여 콘텐츠 유형을 미리 설정할 수 있습니다. |
| AppendSourceFileContent(string contentName, string mediaType?); | 트랜잭션에 가져온 원본 이미지의 바이너리 데이터를 요청 본문에 추가합니다. 콘텐츠 유형은 가져오는 파일의 확장자를 기준으로 자동으로 설정됩니다. 필요한 경우 mediaType 선택적 Parameter를 사용하여 콘텐츠 유형을 미리 설정할 수 있습니다. 중요! 이 메서드는 더 이상 사용되지 않습니다(deprecated). 트랜잭션의 첫 번째 파일에만 접근할 수 있습니다. 대신 AppendFileContent() 메서드를 사용해야 합니다. |
| SetHeader(string name, string value); | 요청에 추가 HTTP 헤더를 설정합니다. 이 메서드는 각 헤더 이름마다 호출해야 합니다. |
| Send(); | HTTP 요청을 전송합니다. |