Notify 콜백
Notify 콜백은 발신자가 전화를 걸려고 할 때 항상 호출됩니다. 이 콜백을 받은 애플리케이션은 착신자에게 전화가 왔다는 것을 알려줘야 합니다.
이때 앱 서버는 반드시 착신자에게 수신한 param 값을 전달해야 합니다. 이 용도로 각 플랫폼에서 지원하는 푸시 시스템(APNs, FCM 등)이나 다른 푸시 알림 시스템을 이용할 수 있습니다.
단, 파라미터 이름을 cc_param으로 바꿔야 합니다. 자세한 내용은 앱 서버의 역할을 참조하세요.
메서드와 URI
- 메서드: GET
- URI:
{notify_cb_url}
쿼리 파라미터
| 파라미터 | 데이터 유형 | Null 허용 | 설명 | 예시 |
|---|---|---|---|---|
sid | String | N | 세션 ID. 이 값을 이용해 통화를 식별할 수 있습니다. Null이 없는 36바이트 고정 길이입니다. | 6364e8b3-bdac-436e-9631-0bce2498ce0c |
from_service_id | String | N | 발신자의 서비스 ID | caller-service-id |
from_user_id | String | N | 발신자의 사용자 ID | caller-user-id |
to_service_id | String | N | 착신자의 서비스 ID | callee-service-id |
to_user_id | String | N | 착신자의 사용자 ID | callee-user-id |
type | String | N | 미디어 유형. A: 음성 통화, V: 영상 통화 | A |
param | String | N | 착신자에게 반드시 전달해야 하는 파라미터. BASE64로 인코딩한 문자열입니다. 앱 서버의 역할을 참고하세요. | rapeyJjYWxsRmxvd1R5cGUiOiJNIiwiY29tbVBhcmFtIjoie1wibXBrZXlcIjpcIkFoTFJVMzBYdVhGZW5UM1o4WmFwVSsyWVBUUHpyWUEyWk9iRHFSenkraHIzXCIsXCJjdG1cIjozMDAwLFwiaWN0XCI6NjAwMH0iLCJjYWxsVHlwZSI6IkEifQ== |
stid | String | Y | Deprecated. PlanetKit의 makeCall()을 호출했을 때 전달된 애플리케이션 데이터 | 애플리케이션이 생성 |
app_svr_data | String | Y | PlanetKit의 makeCall()을 호출했을 때 전달된 애플리케이션 데이터.자세한 내용은 클라이언트 플랫폼별 앱 서버 데이터 가이드를 참조하세요. - Android - iOS - macOS - Windows - Web 참고: 이 파라미터는 stid와 동일한 데이터를 전달합니다. | 애플리케이션이 생성 |
예제
# Let's suppose notify_cb_url is
# http://sample.server.com:20200/notify_cb
# LINE Planet server will send a request to notify_cb_url as follows.
GET http://sample.server.com:20200/notify_cb?
from_user_id=9286&
from_service_id=caller-service-id&
to_user_id=2809&
to_service_id=callee-service-id&
sid=151ad995-749c-4a28-893f-636700469db1&
type=A&
stid=stid&
param=eyJjYWxsRmxvd1R5cGUiOiJNIiwiY29tbVBhcmFtIjoie1wibXBrZXlcIjpcIkFoTFJVMzBYdVhGZW5UM1o4WmFwVSsyWVBUUHpyWUEyWk9iRHFSenkraHIzXCIsXCJjdG1cIjozMDAwLFwiaWN0XCI6NjAwMH0iLCJjYWxsVHlwZSI6IkEifQ%3D%3D&
app_svr_data=appSvrData
Notify 콜백 응답
LINE Planet 서버는 Notify 콜백의 응답 코드 중 200 OK를 성공으로 처리합니다. 앱 서버는 최소 1건 이상의 푸시를 푸시 시스템에 성공적으로 전달한 경우 LINE Planet 서버로 200 OK 응답 코드를 반환해야 합니다.
Notify 콜백 호출에는 타임아웃이 존재합니다. 만약 타임아웃이 발생하거나 앱 서버가 실패 응답(4xx 또는 5xx)을 반환한 경우 LINE Planet 서버는 호출을 실패로 종료하며, 발신자 측에서는 PUSH_ERROR 통화 종료 이유와 함께 발신이 종료됩니다.