RESTAPIResponse - 범위, 전역

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 4분

    • RESTAPIResponse API는 스크립트된 REST API 요청에 대해 RESTful 응답을 빌드할 수 있는 메서드를 제공합니다.

    이 API는 sn_ws 네임스페이스에서 실행됩니다.

    주:
    이 유형의 객체는 인스턴스화할 수 없습니다. 이 유형의 객체는 자동으로 생성되며 스크립팅된 REST API 자원 스크립트에서만 액세스할 수 있습니다.

    RESTAPIResponse - getStreamWriter()

    이 응답에 대한 ResponseStreamWriter를 반환하여 응답 스트림에 직접 쓸 수 있도록 합니다.

    getStreamWriter 함수를 호출하기 전에 setHeaders 및 setStatus 함수를 사용하여 콘텐츠 유형 및 상태 코드를 설정합니다.

    표 1. 매개변수
    이름 유형 설명
    안 함
    표 2. 반환
    유형 설명
    RESTAPIResponseStream - 범위, 전역 이 응답에 대한 ResponseStreamWriter입니다. 이 객체를 사용하여 응답 스트림에 직접 쓸 수 있습니다. 
    response.setContentType('application/json');
response.setStatus(200);
var writer = response.getStreamWriter();

    RESTAPIResponse - setBody(Object body)

    웹 서비스 응답에서 보낼 본문 콘텐츠를 설정합니다.

    표 3. 매개변수
    이름 유형 설명
    본문 객체

    JavaScript 객체로 표시되는 응답 본문입니다.

    본문 컨텐츠는 요청에 전달된 헤더 값 Accept 에 따라 JSON 또는 XML로 자동으로 직렬화됩니다.
    표 4. 반환
    유형 설명
    무효 
    var body = {};
body.name = "incident";
body.number = "1234";
body.caller = {"id": "user1"};
response.setBody(body);

    var bodyArray = [];
var body = {};
body.name = "incident";
body.number = "1234";
body.caller = {"id":"user1"};
bodyArray.push(body);
response.setBody(bodyArray);

    RESTAPIResponse - setContentType(문자열 contentType)

    웹 서비스 응답의 Content-Type 헤더에 값을 할당합니다.

    응답을 작성하기 전에 응답 콘텐츠 유형을 설정해야 합니다. 콘텐츠 유형은 요청 수락 헤더 값에 따라 문자열 응답에 대해 자동으로 설정됩니다.

    잘못된 컨텐츠 유형을 설정하면 응답이 기본적으로 JSON으로 설정됩니다. 컨텐츠 유형을 설정하지 않으면 이진 응답을 보낼 때 상태 코드 500 오류가 발생합니다.

    이 헤더에 대한 자세한 내용은 W3 Content-Type 헤더 설명서 를 참조하십시오.

    표 5. 매개변수
    이름 유형 설명
    contentType 문자열 응답 본문의 콘텐츠 유형(예: application/json)입니다.
    표 6. 반환
    유형 설명
    무효 
    response.setContentType('application/json');

    RESTAPIResponse - setError(개체 오류)

    오류를 반환하도록 REST 응답을 구성합니다.

    표 7. 매개변수
    이름 유형 설명
    오류 객체 오류 객체.

    사용할 수 있는 오류 객체의 유형에 대한 자세한 내용은 다음 문서를 참조하십시오 스크립팅된 REST API 예제 - 스크립트 샘플.
    표 8. 반환
    유형 설명
    무효

    다음 예제는 스크립팅된 REST 자원 내에서 오류를 반환하는 방법을 보여줍니다.

    var queryParams = request.queryParams;
var userId = String(queryParams.user_id || '');
var fileId = String(queryParams.file_id || '');
if (!userId || !fileId){
  response.setError(new sn_ws_err.BadRequestError('Missing required parameters.'));
  return;
}

    RESTAPIResponse - setHeader(String 헤더, 문자열 값)

    REST 서비스 응답 헤더에 값을 할당합니다.

    표 9. 매개변수
    이름 유형 설명
    헤더 문자열 설정하려는 헤더입니다.
    값 문자열 지정된 헤더를 할당할 값입니다.
    표 10. 반환
    유형 설명
    무효 
    response.setHeader("Location","<URI>");

    RESTAPIResponse - setHeaders(객체 헤더)

    웹 서비스 응답에 대한 헤더를 설정합니다.

    표 11. 매개변수
    이름 유형 설명
    헤더 객체 각 헤더와 해당 헤더에 할당할 값을 나열하는 JavaScript 객체입니다.
    표 12. 반환
    유형 설명
    무효 
    var headers = {};
headers.X-Total-Count=100;
headers.Location='https://instance.service-now.com/<endpoint_to_resource>';
response.setHeaders(headers);

    RESTAPIResponse - setLocation(문자열 위치)

    웹 서비스 응답의 위치 헤더에 값을 할당합니다.

    이 헤더에 대한 자세한 내용은 W3 위치 헤더 설명서 를 참조하십시오.

    표 13. 매개변수
    이름 유형 설명
    없음 문자열 응답 수신자를 리디렉션할 절대 URI입니다.
    표 14. 반환
    유형 설명
    무효

    RESTAPIResponse - setStatus(Number status)

    웹 서비스 응답의 상태 코드 번호를 설정합니다.

    표 15. 매개변수
    이름 유형 설명
    상태 번호 응답에서 보낼 상태 코드입니다(예: 성공을 나타내기 위한 200). 문자열과 같이 숫자가 아닌 값을 전달하면 상태 코드의 기본값은 0으로 설정됩니다.
    표 16. 반환
    유형 설명
    무효 
    response.setStatus(200);