---
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


---

# RESTAPIRequestBody - 범위, 전역

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

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

RESTAPIRequestBody API는 스크립트에서 스크립트된 REST API 요청의 본문 컨텐츠에 액세스할 수 있는 메서드를 제공합니다.  
RESTAPIRequestBody 개체의 형식은 요청의 콘텐츠 형식 헤더 값에 따라 JSON 또는 XML일 수 있습니다.  
주:  
이 유형의 객체는 인스턴스화할 수 없습니다. 이 유형의 객체는 자동으로 생성되며 스크립팅된 REST API 자원 스크립트에서만 액세스할 수 있습니다.

이 API는 `sn_ws` 네임스페이스에서 실행됩니다.  
JSON 형식의 단일 항목 example-request-body.

    {
     "name": "user1",
     "id": 1234,
     "roles": [
      {
       "name": "admin"
      },
      {
       "name": "itil"
      }
     ]
    }

JSON 형식의 여러 항목 example-request-body.

    [{
     "name": "user1",
     "id": 1234,
     "roles": [
      {
       "name": "admin"
      },
      {
       "name": "itil"
      }
     ]
    },{
     "name": "user2",
     "id":9876,
     "roles": [
      {
       "name":"admin"
      }
     ]
    }]

## RESTAPIRequestBody - 데이터 {#ariaid-title2}

요청 본문의 컨텐츠입니다.
주:  
REST 웹 서비스는 스트림을 통해 데이터, 데이터스트림 및 데이터문자열을 사용합니다. 스트림은 한 번만 사용되기 때문에 스트림은 하나만 호출할 수 있습니다. 예를 들어 data와 dataString을 모두 호출하는 경우 두 번째 호출은 빈 것을 반환합니다.
{#r_SSRB_data__table_fvt_qv1_sr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 데이터 | 객체 또는 배열 | 요청 컨텐츠입니다. 요청에 따라 단일 객체 또는 객체 배열이 될 수 있습니다. |
[표 1. 필드]

{#r_SSRB_data__table_fvt_qv1_sr}  

    var entry;
    var id;
    var requestBody = request.body;
    var requestData = requestBody.data; //May be an array or a single object
    if (requestData instanceof Array) { 
     entry = requestData[0].name; // 'user1'
     id = requestData[0].id; // '1234'
    } else {
     entry = requestData.name; // 'user1'
     id = requestData.id; // '1234'
    }

## RESTAPIRequestBody - dataStream {#ariaid-title3}

스트림으로 표시되는 요청 본문의 컨텐츠입니다.
주:  
REST 웹 서비스는 스트림을 통해 데이터, 데이터스트림 및 데이터문자열을 사용합니다. 스트림은 한 번만 사용되기 때문에 스트림은 하나만 호출할 수 있습니다. 예를 들어 data와 dataString을 모두 호출하는 경우 두 번째 호출은 빈 것을 반환합니다.
{#r_SSRB_dataStream__table_ycm_sw1_sr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 데이터 스트림 | 객체 | 요청 본문의 컨텐츠입니다. 요청에서 첨부 파일을 만들거나 요청을 다른 엔드포인트로 전달하는 등 스트림을 별도의 API에 전달할 수 있습니다. |
[표 2. 필드]

{#r_SSRB_dataStream__table_ycm_sw1_sr}  

    var requestBody = request.body; 
    var requestStream = requestBody.dataStream;

## RESTAPIRequestBody - dataString {#ariaid-title4}

문자열로 표시되는 요청 본문의 내용입니다.
주:  
REST 웹 서비스는 스트림을 통해 데이터, 데이터스트림 및 데이터문자열을 사용합니다. 스트림은 한 번만 사용되기 때문에 스트림은 하나만 호출할 수 있습니다. 예를 들어 data와 dataString을 모두 호출하는 경우 두 번째 호출은 빈 것을 반환합니다.
{#r_SSRB_dataString__table_k3m_mw1_sr__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 데이터 문자열 | 문자열 | 요청 본문의 컨텐츠입니다. |
[표 3. 필드]

{#r_SSRB_dataString__table_k3m_mw1_sr}  

    var requestBody = request.body; 
    var requestString = requestBody.dataString;

## RESTAPIRequestBody - hasNext() {#ariaid-title5}

요청 본문에 추가 항목이 있는지 확인합니다.
nextEntry() 메서드와 함께 이 메서드를 사용하여 여러 요청 본문 항목을 반복합니다.
{#r_SSRB-hasNext__table_ztm_my1_sr__entry__3}

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

{#r_SSRB-hasNext__table_ztm_my1_sr} {#r_SSRB-hasNext__table_a5m_my1_sr__entry__2}

| 유형 | 설명 |
|-|-|
| 부울 | 요청 본문에 추가 항목이 있는지 여부를 나타내는 플래그입니다. 가능한 값: * true: 추가 항목을 사용할 수 있습니다. nextEntry()가 호출되면 hasNext()는 마지막 일치 기록이 로드될 때까지 계속 true입니다. * false: 추가 항목이 없습니다. {#r_SSRB-hasNext__ul_sng_zt5_knb} |
[표 5. 반환]

{#r_SSRB-hasNext__table_a5m_my1_sr}  

    var requestBody = request.body;
    requestBody.hasNext(); // returns true if the request contains a single entry or multiple entries
    requestBody. nextEntry(); // returns next available entry

    //calling second time
    requestBody.hasNext(); // returns false if the request contains a single entry, or true if the request contains multiple entries

## RESTAPIRequestBody - nextEntry() {#ariaid-title6}

요청 본문에서 하나의 항목을 스크립트 객체로 검색합니다.
hasNext() 메서드와 함께 이 메서드를 사용하여 여러 요청 본문 항목을 반복합니다.
{#r_SSRB-nextEntry__table_ssb_nx1_sr__entry__3}

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

{#r_SSRB-nextEntry__table_ssb_nx1_sr} {#r_SSRB-nextEntry__table_tsb_nx1_sr__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 요청 본문의 단일 항목입니다. |
[표 7. 반환]

{#r_SSRB-nextEntry__table_tsb_nx1_sr}  

    var requestBody = request.body;
    var requestEntry = requestBody.nextEntry(); // returns available entry if there is only one entry, or the first entry if there are multiple.
    var name = requestEntry.name; // 'user1'

    // Calling second time
    requestEntry = requestBody.nextEntry(); // returns undefined if there is only one entry, or the second entry if there are multiple.

이 예제에서는 nextEntry()와 함께 hasNext()를 사용하는 방법을 보여줍니다.

    var requestBody = request.body;
    while(requestBody.hasNext()){
    var entry = requestBody.nextEntry();
    }