APNS Notification Payload

Payload

공급자 서버가 APN (ApplePushNotification Service)에 보내는 각 알림에는 페이로드가 포함되어 있다.

알림을 보내기 위해 메시지를 정의하고, 옵션을 선택하는 등의 역할을 하는  json 형태의 데이터다.

특징

- Json 형태의 데이터

- 디바이스로 알림을 보내기 위한 옵션 및 메시지 설정

- TCP Binary API 를 이용하여 보낼 시 최대 2KB 전송 가능

- HTTP/2 API 로 보낼 시 최대 4KB 데이터 전송 가능

- VolP 알림으로 보낼 시 최대 5KB 데이터 전송 가능

ex)

{
   "aps" : {
      "category" : "NEW_MESSAGE_CATEGORY"
      "alert" : {
         "body" : "Acme message received from Johnny Appleseed",
      },
      "badge" : 3,
      "sound" : “chime.aiff"
   }
}

※ Aps Key에 대한 Json Dictionary

key	Value	설명
Alert	String , 혹은 json dictionary
Badge	Number	0의 값은 뱃지를 제거
Sound	String	Apple 에서 지정한 string 문자열
Content-available	Number	1의 값은 백그라운드에서 앱을 깨우고 알림을 전달
category	String	알림의 식별자 값 지정
Thread-id	String	그룹화 알림을위한 앱 별 식별자를 나타내는 문자열 값을이 키에 입력하십시오. 알림 콘텐츠 추가 앱 정보를 제공하는 경우이 값을 사용하여 알림을 그룹화 할 수 있습니다.

※ Alert Key에 대한 Json Dictionary

key	Value	설명
Title	String	알림의 제목
Body	String	알림의 내용
Title-loc-key	String or null	로컬 라이즈 용의 파일 내의 타이틀 캐릭터 라인의 키
Title-loc-args	Array of String or null	가변 문자열 값의 형식 지정자의 장소에 표시
Action-loc-key	String or nullString	문자열을 지정하면 닫기 및보기 단추가 포함 된 경고가 표시됩니다.
Loc-key	String	현재 지역화 파일 의 경고 메시지 문자열에 대한 키
Loc-args	Array of string	가변 문자열 값의 형식 지정자의 장소에 표시
Launch-image	String	파일 이름 확장자의 유무에 관계없이 앱 번들에있는 이미지 파일의 파일 이름입니다. 사용자가 작업 버튼을 누르거나 작업 슬라이더를 움직일 때 이미지가 실행 이미지로 사용됩니다.