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


---

# 가져오기 - 범위, 전역

# 가져오기 - 범위, 전역 {#ariaid-title1}

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

가져오기 API는 요청 및 응답 객체를 사용하여 자원을 가져오는 메서드를 제공합니다.

백그라운드 스크립트에서 그리고 HTTP 호출을 할 수 있는 모든 곳(예: REST 엔드포인트)에서 Fetch API를 사용할 수 있습니다. Fetch API를 사용하면 헤더, 본문 옵션 등을 설정하여 간단한 가져오기 요청과 더 복잡한 가져오기 요청을 모두 수행할 수 있습니다.  
이 API는 외부 웹 사이트에서 자원을 가져오기 위한 다양한 작업을 제공하는 Fetch API 집합의 일부입니다. 전체 Fetch API 컬렉션에는 다음이 포함됩니다.

* [페치 - 페치(문자열 자원, 객체 옵션)](https://servicenow-prod.fluidtopics.net/cC_Q8Kzj_58nuPp_71I0eQ#fetch.fetch_S_O "네트워크에서 자원을 가져오는 프로세스를 시작하고 응답을 사용할 수 있게 되면 이행되는 약속을 반환합니다."): 네트워크에서 자원을 가져오는 프로세스를 시작합니다.
* [헤더 가져오기 - 범위, 전역](https://servicenow-prod.fluidtopics.net/TQ_s4qDBI8LI7b~lg02JWw#Fetch.HeadersAPI "헤더 가져오기 API를 사용하면 요청 또는 응답 헤더 목록에서 헤더를 검색, 설정, 추가 및 제거할 수 있습니다."): 요청 및 응답 헤더를 검색하고 수정합니다.
* [가져오기 요청 - 범위, 전역](https://servicenow-prod.fluidtopics.net/tg4UwTEaFmBrnM6TU50UyA#Fetch.RequestAPI "요청 가져오기 API에는 애플리케이션이 서버에서 JSON, 텍스트 또는 이진 데이터와 같은 자원을 비동기적으로 요청하고 응답을 처리할 수 있도록 요청 객체를 만들거나 검색하는 메서드가 포함되어 있습니다. 이 API는 GET, POST, PUT, DELETE 등과 같은 다양한 HTTP 메서드를 지원합니다."): 새 요청 객체를 만듭니다.
* [RequestInit 가져오기 - 범위, 전역](https://servicenow-prod.fluidtopics.net/4xEgjtsDO31eT6OOzCH5jg#Fetch.RequestInitAPI "RequestInit API는 가져오기 요청을 구성하는 옵션을 제공합니다."): 가져오기 요청을 구성하는 옵션을 설정합니다.
* [응답 가져오기 - 범위, 전역](https://servicenow-prod.fluidtopics.net/ct1TFkBEIEoUYJHRNPkDTg#Fetch.ResponseAPI "응답 가져오기 API는 새 응답 객체를 생성하고 요청 가져오기 API 메서드에서 생성된 응답 본문을 처리하는 메서드를 제공합니다."): 새 응답 객체를 생성합니다.
{#FetchAPI__ul_akb_fsf_pdc}

가져오기 작업을 지원하기 위해 시스템 속성인 `glide.hosts.allowlist`를 사용하면 가져오기 메서드가 액세스할 수 있는 호스트를 제어할 수 있습니다. RestMessageV2 및 위에서 언급한 것과 같은 HTTP API에 적용됩니다. `glide.hosts.allowlist`에 대한 자세한 내용은 다음 문서를 참조하십시오[Available system properties](https://www.servicenow.com/docs/access?context=r_AvailableSystemProperties&version=australia&pubname=australia-platform-administration&ft:locale=en-US).

## 페치 - 페치(문자열 자원, 객체 옵션) {#ariaid-title2}

네트워크에서 자원을 가져오는 프로세스를 시작하고 응답을 사용할 수 있게 되면 이행되는 약속을 반환합니다.
{#fetch.fetch_S_O__table_arq_npb_jdc__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 자원 | 문자열 또는 객체 | 필수 가져올 자원입니다. 허용되는 값: * 가져올 자원의 URL을 제공하는 문자열 또는 URL 객체를 포함하여 stringifier가 있는 객체입니다. URL은 문서의 baseURI인 기본 URL을 기준으로 할 수 있습니다. * 개체입니다 [요청 가져오기 - request()](https://servicenow-prod.fluidtopics.net/tg4UwTEaFmBrnM6TU50UyA#fetch.request-constructor "새 요청 객체를 생성합니다. 선택적으로 URL 또는 개체 자원에서 요청 개체를 만듭니다.") . {#fetch.fetch_S_O__ul_lbz_kqb_jdc} |
| 옵션 | 객체 | 옵션입니다. 요청에 [RequestInit 가져오기 - 범위, 전역](https://servicenow-prod.fluidtopics.net/4xEgjtsDO31eT6OOzCH5jg#Fetch.RequestInitAPI "RequestInit API는 가져오기 요청을 구성하는 옵션을 제공합니다.") 적용할 사용자 지정 설정을 포함하는 객체입니다. 기본값: 커스터마이제이션 설정 없이 요청이 전달됩니다. |
[표 1. 매개변수]

{#fetch.fetch_S_O__table_arq_npb_jdc} {#fetch.fetch_S_O__table_brq_npb_jdc__entry__2}

| 유형 | 설명 |
|-|-|
| 객체 | 응답 객체로 해결되는 약속입니다. fetch() 약속은 요청 URL의 형식이 잘못되었거나 네트워크 오류로 인해 요청이 실패할 때만 거부합니다. 주: 서버가 404 또는 504와 같은 오류를 나타내는 HTTP 상태 코드로 응답하는 경우 fetch( ) 약속은 거부된 것으로 간주되지 않습니다. 이 인스턴스에서는 then() 처리기를 사용하여 ok 및 status [응답 가져오기 - 범위, 전역](https://servicenow-prod.fluidtopics.net/ct1TFkBEIEoUYJHRNPkDTg#Fetch.ResponseAPI "응답 가져오기 API는 새 응답 객체를 생성하고 요청 가져오기 API 메서드에서 생성된 응답 본문을 처리하는 메서드를 제공합니다.")속성을 확인합니다. |
[표 2. 반환]

{#fetch.fetch_S_O__table_brq_npb_jdc}  
다음 예제에서는 데이터를 검색하기 위해 fetch()를 사용하여 [요청 가져오기 - request()](https://servicenow-prod.fluidtopics.net/tg4UwTEaFmBrnM6TU50UyA#fetch.request-constructor "새 요청 객체를 생성합니다. 선택적으로 URL 또는 개체 자원에서 요청 개체를 만듭니다.") 새 Request 객체를 구성하는 방법을 보여줍니다. 다음은 코드의 각 부분이 사용되는 방법에 대한 간단한 설명입니다.

* request(): URL, 메서드 및 헤더로 API 요청을 구성합니다.
* fetch(): 가져오기 요청을 합니다.
* response.json(): JSON 응답 본문을 JavaScript 객체로 구문 분석합니다. (자세한 내용은 참조 [응답 가져오기 - json()](https://servicenow-prod.fluidtopics.net/ct1TFkBEIEoUYJHRNPkDTg#fetch.response-json "본문 텍스트를 JSON으로 구문 분석한 결과로 확인되는 약속을 반환합니다.") )
* console.log(): 콘솔 API를 사용하여 인시던트(data.result)를 출력합니다( [콘솔 - log(Object val1... val2, 문자열 메시지, 문자열 subst1... subst2)](https://servicenow-prod.fluidtopics.net/xRkc_6HqTtGxluRnW4LdVQ#console-log_O_S_S "시스템 로그에 메시지를 기록합니다.")참조).
{#fetch.fetch_S_O__ul_d4f_5br_c2c}

    async function fetchIncidents() {
        const url = 'https://your-instance.service-now.com/api/now/table/incident';
        const username = 'your_username';
        const password = 'your_password';

        // Create a Request object
        const request = new Request(url, {
            method: 'GET',
            headers: {
                'Content-Type': 'application/json',
                Authorization: 'Basic ' + btoa(`${username}:${password}`)
            }
        });

        // Fetch data and use response.json() to process it
        const response = await fetch(request);
        const data = await response.json(); // Parse the response to JSON
        console.log(data.result); // Log the incidents data to system logs
    }

    fetchIncidents();

출력:

    [
        { "number": "INC0001", "short_description": "System outage" },
        { "number": "INC0002", "short_description": "Password reset request" }
    ]