본문으로 건너뛰기

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

메서드와 URI
쿼리 파라미터
예제