메인 콘텐츠로 건너뛰기
application/x-www-form-urlencoded, 텍스트 및 이진 데이터를 포함하는 HTTP 요청입니다.

Properties

NameTypeDescription
Urlstring리소스 URL입니다.
Methodstring요청 유형입니다(예: GET 또는 POST).
AuthTokenstring인증 토큰입니다(외부 서비스 인증이 필요한 경우).
AuthSchemestring인증 스킴입니다.
ThrowExceptionOnFailedboolean외부 서비스가 HTTP 응답 상태로 오류 코드를 반환할 때(즉, 200-299 범위 밖) 예외를 발생시켜야 하는지 여부를 지정합니다. False로 설정하면, 외부 서비스가 HTTP 응답 상태로 오류 코드를 반환하더라도 예외가 발생하지 않습니다. HTTP 응답 코드의 상태를 보려면 Status 속성의 값을 확인합니다. 기본값은 True입니다. 중요! 응답에 오류 코드가 포함된 경우, 이는 외부 서비스가 정상 작동 중이며 요청에 대한 응답을 보내고 있음을 의미합니다. HTTP 요청을 보내는 동안 서비스 가용성 또는 인터넷 연결 상태와 관련된 오류가 발생하면, 이 경우에는 외부 서비스의 HTTP 상태 코드가 제공되지 않으므로 이 속성 값과 관계없이 프로그램 예외가 발생합니다.
Timeoutnumber요청 제한 시간(단위: 분)입니다. 기본값은 1분입니다. 중요! 요청 제한 시간 값은 스크립트 실행 시간 제한(600초)보다 클 수 없습니다.
ResponseTextstring, read-only텍스트 형식의 응답 내용입니다.
ResponseTypestring, read-only서비스에서 반환된 요청 응답의 유형입니다(예: “application/json”).
Statusnumber외부 서비스의 HTTP 응답 상태 코드입니다. ThrowExceptionOnFailed가 True로 설정된 경우, 오류 코드는 예외를 발생시키며 트랜잭션이 중단됩니다. 오류 메시지 텍스트는 Skill Monitor에서 확인할 수 있습니다.

Methods

NameDescription
SetHeader(string name, string value);요청에 사용할 추가 HTTP 헤더를 설정합니다. 이 메서드는 각 헤더 이름마다 한 번씩 호출해야 합니다.
Send();HTTP 요청을 전송합니다.
SetFileContent(DocumentExportResult documentExportResult, string mediaType?);내보낸 데이터를 파일로 전달할 수 있도록 플로우 기반 HTTP 요청을 초기화합니다. 전달되는 콘텐츠 유형은 내보낸 파일의 확장자를 기준으로 자동으로 설정됩니다(예: application/json, application/pdf). 필요한 경우 선택적 매개변수 mediaType을 사용해 콘텐츠 유형을 미리 설정할 수 있습니다.
SetFileContent(BinaryFile binaryFile, string mediaType?);트랜잭션이 생성될 때 가져온 원본 이미지 파일 또는 Picture 유형 field에 포함된 이미지를 전달하여 바이너리 데이터 기반 HTTP 요청을 초기화합니다. 전달되는 콘텐츠 유형은 가져온 파일의 확장자를 기준으로 자동으로 설정됩니다. 필요한 경우 선택적 매개변수 mediaType을 사용해 콘텐츠 유형을 미리 설정할 수 있습니다.
SetSourceFileContent(string mediaType?);트랜잭션이 생성될 때 가져온 원본 이미지 파일을 전달할 수 있도록 바이너리 데이터 기반 HTTP 요청을 초기화합니다. 전달되는 콘텐츠 유형은 가져온 파일의 확장자를 기준으로 자동으로 설정됩니다. 필요한 경우 선택적 매개변수 mediaType을 사용해 콘텐츠 유형을 미리 설정할 수 있습니다. 중요! 이 메서드는 더 이상 사용되지 않습니다(Deprecated). 이 메서드는 트랜잭션의 첫 번째 파일에만 접근할 수 있습니다. 대신 SetFileContent() 메서드를 사용해야 합니다.
SetStringContent(string content, ContentEncoding contentEncoding?, string mediaType?);string 기반 HTTP 요청을 초기화합니다. 기본적으로 Content-Type은 UTF-8 인코딩의 application/json으로 설정됩니다. 필요한 경우 콘텐츠 유형과 인코딩 유형을 모두 변경할 수 있습니다.
SetUrlFormEncodedContent(any content);JavaScript 객체 기반 요청의 콘텐츠를 초기화하고, 이를 application/x-www-form-urlencoded 형식으로 인코딩합니다. JavaScript 객체는 단순한 속성 값 집합으로 초기화해야 합니다. 예: var form = {}; form.grant_type = "password"; form.scope = "openid permissions"; form.client_id = "value of client_id"; form.client_secret = "value of client_secret"; form.password = "Password"; form.username = "User Name"; request.SetUrlFormEncodedContent(form);