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


---

# 푸시 설치 API

# 푸시 설치 API {#ariaid-title1}

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

푸시 설치 API는 모바일 장치가 애플리케이션에서 푸시 알림을 받을 수 있도록 하는 토큰을 등록 및 등록 취소할 수 있는 엔드포인트를 제공합니다.
푸시 알림은 사용자의 모바일 장치에 나타나 중요한 사항을 알리거나 동작을 수행하도록 요청하는 텍스트 메시지입니다.

사용자 지정 모바일 애플리케이션을 만들 때 푸시 알림을 설정하려면 제조업체의 서비스에 장치를 등록해야 합니다. 서비스는 푸시 토큰을 사용하여 해당 장치에 알림을 올바르게 보낼 수 있도록 사용자 장치의 주소를 알고 있어야 합니다. 또한 장치는 알림을 수신하고 조치를 취할 수 있어야 합니다. 장치를 등록하고 푸시 토큰을 가져오는 방법에 대한 지침은 장치의 운영 체제 개발자 설명서를 참조하십시오. 예를 들어, Apple 장치의 경우 다음을 <https://developer.apple.com/documentation/usernotifications/registering_your_app_with_apns>참조하십시오.

## 푸시 설치 - POST /now/push/{pushApplicationName}/installation {#ariaid-title2}

장치가 지정된 애플리케이션에서 푸시 알림을 받을 수 있도록 하는 토큰을 추가하거나 업데이트합니다.

### URL 형식 {#push-POST-installation__section_x12_fqg_dmb}

버전이 지정된 URL: /api/now/{api_version}/push/{pushApplicationName}/installation

기본 URL: /api/now/push/{pushApplicationName}/installation  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#push-POST-installation__entry__2}{#push-POST-installation__version-not_optional-RESTAPI}

| 매개변수 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| 푸시 애플리케이션 이름 | 푸시 알림을 등록할 애플리케이션의 이름입니다. 이 매개변수는 연결된 애플리케이션의 이름 열에 있는 값과 같아야 합니다. 데이터 유형: 문자열 테이블: 푸시 애플리케이션 \[sys_push_application\] |
[표 1. 경로 매개변수]

{#push-POST-installation__entry__8}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 2. 쿼리 매개변수]

{#push-POST-installation__entry__12}

| 요소 | 설명 |
|-|-|
| 플랫폼 | 푸시 알림을 등록할 플랫폼입니다. 데이터 유형: 문자열 테이블: 푸시 플랫폼 \[sys_push_platform\] 테이블의 이름 필드에 있습니다. |
| 토큰 | 모바일 애플리케이션이 푸시 알림을 수신하도록 등록할 때 Apple과 같은 장치 제조업체에서 제공하는 토큰입니다. 데이터 유형: 문자열 저장 위치: 푸시 알림 설치 \[sys_push_notif_app_install\] |
[표 3. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#push-POST-installation__entry__18}{#push-POST-installation__content_type-JSON-only-entry-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 4. 요청 헤더]

{#push-POST-installation__entry__22}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#push-POST-installation__entry__26}{#push-POST-installation__entry-200-status-code}{#push-POST-installation__entry-401-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다. |
[표 6. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#push-POST-installation__entry__36}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[ ]

### 샘플 cURL 요청

    curl -X POST \
      https://instance.servicenow.com/api/now/push/ServiceNowPushApp/installation \
    --header "Content-Type: application/json" \
    --user "username":"password" \
    --data '{"platform":"Apple","token":"544836d77ac2e551bbf78204630509a7d494fc87f52e85da52e5b5d42910e2cf"}' \

    None

## 푸시 설치 - POST /now/push/{pushApplicationName}/removeInstallation {#ariaid-title3}

모바일 장치가 지정된 애플리케이션에서 푸시 알림을 수신할 수 있도록 하는 토큰을 비활성화합니다.

### URL 형식 {#push-POST-removeInstallation__section_uy3_drg_dmb}

버전 관리된 URL: /api/now/{api_version}/push/{pushApplicationName}/removeInstallation

기본 URL: /api/now/push/{pushApplicationName}/removeInstallation  
주:  
사용 가능한 버전은 [REST API 탐색기에](https://servicenow-prod.fluidtopics.net/arCv9b3UPYvLylUnDh9RpQ "이 튜토리얼에서는 REST API 탐색기를 사용하여 REST API를 테스트합니다 ServiceNow .") 지정됩니다. 스크립트 기반 REST API의 경우 [스크립트 기반 REST 서비스 양식](https://servicenow-prod.fluidtopics.net/vfCIdYdXpX8Ltk8_R7WfkA "스크립팅된 REST API 기능을 사용하면 애플리케이션 개발자가 사용자 지정 웹 서비스 API를 빌드할 수 있습니다.")에 추가 버전 정보가 있습니다.

### 지원되는 요청 매개변수

{#push-POST-removeInstallation__entry__2}{#push-POST-removeInstallation__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| 푸시 애플리케이션 이름 | 푸시 알림의 등록을 취소할 애플리케이션의 이름입니다. 데이터 유형: 문자열 테이블: 밀어넣기 애플리케이션 \[sys_push_application\] 테이블에 있는 연결된 애플리케이션의 이름 필드에 있습니다. |
[표 7. 경로 매개변수]

{#push-POST-removeInstallation__entry__8}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 8. 쿼리 매개변수]

{#push-POST-removeInstallation__entry__12}

| 요소 | 설명 |
|-|-|
| 플랫폼 | 푸시 알림을 등록할 플랫폼입니다. 데이터 유형: 문자열 테이블: 푸시 플랫폼 \[sys_push_platform\] 테이블의 이름 필드에 있습니다. |
[표 9. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#push-POST-removeInstallation__entry__16}{#push-POST-removeInstallation__content_type-JSON-only-entry-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 10. 요청 헤더]

{#push-POST-removeInstallation__entry__20}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 11. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#push-POST-removeInstallation__entry__24}{#push-POST-removeInstallation__entry-200-status-code}{#push-POST-removeInstallation__entry-401-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 서버 측 코드에서 논리 오류가 발생했습니다. |
[표 12. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#push-POST-removeInstallation__entry__34}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[ ]

### 샘플 cURL 요청

    curl -X POST \
      https://instance.servicenow.com/api/now/push/ServiceNowPushApp/removeInstallation \
    --header "Content-Type: application/json" \
    --user "username":"password" \
    --data '{"platform":"Apple"}' \

    None