---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# RESTAPIRequest - 범위, 전역

# RESTAPIRequest - 범위, 전역 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 4분

RESTAPIRequest API는 스크립트에서 스크립트된 REST API 요청 세부 정보에 접근할 수 있는 메서드를 제공합니다.

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

## RESTAPIRequest - 본문 {#ariaid-title2}

요청의 본문입니다.
{#r_SSR_body__table_a3m_rt1_sr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 본문 | [RESTAPIRequest본문](https://servicenow-prod.fluidtopics.net/_5F21FYyCXhRuJHJfR7Czg#c_ScriptableServiceRequestBody "RESTAPIRequestBody API는 스크립트에서 스크립트된 REST API 요청의 본문 컨텐츠에 액세스할 수 있는 메서드를 제공합니다.") | 요청의 본문입니다. RESTAPIRequestBody API를 사용하여 body 객체의 데이터에 액세스할 수 있습니다. |
[표 1. 필드]

{#r_SSR_body__table_a3m_rt1_sr}  

    var requestBody = request.body // Returns instance of RESTAPIRequestBody

## RESTAPIRequest - getHeader(문자열 헤더) {#ariaid-title3}

웹 서비스 요청에서 특정 헤더의 값을 반환합니다.
{#r_SSR-getHeader_String__table_q32_q2r_qr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 헤더 | 문자열 | 헤더의 이름(예 accept : 또는 content-type)입니다. |
[표 2. 매개변수]

{#r_SSR-getHeader_String__table_q32_q2r_qr} {#r_SSR-getHeader_String__table_r32_q2r_qr__entry__2}

| 유형 | 설명 |
|-|-|
| 문자열 | 지정된 헤더의 값입니다. |
[표 3. 반환]

{#r_SSR-getHeader_String__table_r32_q2r_qr}  

    var acceptHeader = request.getHeader('accept');

## RESTAPIRequest - getSupportedResponseContentTypes() {#ariaid-title4}

요청 수락 헤더에 지정된 콘텐츠 유형을 가져옵니다.
{#r_SSR-getSupportedRespContentTypes__table_rtm_qg3_zs__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 안 함 |   |   |
[표 4. 매개변수]

{#r_SSR-getSupportedRespContentTypes__table_rtm_qg3_zs} {#r_SSR-getSupportedRespContentTypes__table_stm_qg3_zs__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 | 각 문자열이 application/json과 같은 콘텐츠 유형인 문자열 값의 배열입니다. |
[표 5. 반환]

{#r_SSR-getSupportedRespContentTypes__table_stm_qg3_zs}

## RESTAPIRequest - 헤더 {#ariaid-title5}

요청의 모든 헤더입니다.
{#r_SSR_headers__table_zmm_3s1_sr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 헤더 | 객체 | 요청의 모든 헤더와 해당 값입니다. |
[표 6. 필드]

{#r_SSR_headers__table_zmm_3s1_sr}  

    var headers = request.headers; 
    var acceptHeader = headers.Accept;
    var myCustomHeader = headers.myCustom; 
    var specialHeader = headers['special - header'];

## RESTAPIRequest - pathParams {#ariaid-title6}

요청 URI에 전달되는 경로 매개변수입니다.
{#r_SSR_pathParams__table_zsf_jr1_sr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| pathParams | 객체 | 스크립트 객체로서의 경로 매개변수입니다. 사용 가능한 경로 매개변수는 웹 서비스 구성에 따라 다릅니다. |
[표 7. 필드]

{#r_SSR_pathParams__table_zsf_jr1_sr}  
이 예에서 스크립트된 REST API 엔드포인트는 https://instance.service-now.com/api/now/myservice/{tableName}/{id} 형식을 따릅니다. 처리 중인 요청은 https://instance.service-now.com/api/now/myservice/myApp_table/1234 URL을 사용합니다.

    var pathParams = request.pathParams; 
    var tableName = pathParams.tableName; //'myApp_table' 
    var id = pathParams.id; //'1234'

## RESTAPIRequest - queryParams {#ariaid-title7}

웹 서비스 요청의 쿼리 매개변수입니다.
{#r_SSR_queryParams__table_gzw_yg5_rr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| queryParams | 배열 | 웹 서비스 요청의 쿼리 매개변수입니다. |
[표 8. 필드]

{#r_SSR_queryParams__table_gzw_yg5_rr}  
이 예에서 처리 중인 요청은 https://\<instance_rest_endpoint\>?active=false\&name=now URL을 사용합니다. 및 name 매개변수를 active 참고하십시오.

    var queryParams = request.queryParams; 
    var isActiveQuery = queryParams.active; // [false] 
    var nameQueryVal = queryParams.name; // ['now']

## RESTAPIRequest - queryString {#ariaid-title8}

엔드포인트 URI에 추가된 전체 쿼리입니다.
{#r_SSR_queryString__table_zwx_5q1_sr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| queryString | 문자열 | 요청에 대한 전체 쿼리입니다. |
[표 9. 필드]

{#r_SSR_queryString__table_zwx_5q1_sr}  
이 예에서 처리 중인 요청은 https://\<instance_rest_endpoint\>?active=false\&name=now URL을 사용합니다. `active=false&name=now` 쿼리를 참고하십시오.

    var query = request.queryString; //"active=false&name=now"

## RESTAPIRequest - uri {#ariaid-title9}

도메인 정보를 제외한 요청 URI입니다.
{#r_SSR_uri__table_h5d_ct1_sr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| uri | 문자열 | 도메인 정보를 제외한 요청 URI입니다. |
[표 10. 필드]

{#r_SSR_uri__table_h5d_ct1_sr}  
이 예에서 처리 중인 요청은 https://instance.service-now.com/api/now/table/myTable?active=false\&name=now URL을 사용합니다.

    var query = request.uri; //"api/now/table/myTable"

## RESTAPIRequest - url {#ariaid-title10}

전체 요청 URL입니다.
{#r_SSR_url__table_zdq_qs1_sr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| URL | 문자열 | 전체 요청 URL입니다. |
[표 11. 필드]

{#r_SSR_url__table_zdq_qs1_sr}  
이 예에서 처리 중인 요청은 https://instance.service-now.com/api/now/table/myTable?active=false\&name=now URL을 사용합니다.

    var query = request.url; //"https://instance.service-now.com/api/now/table/myTable?active=false&name=now"