1대1 통화 이벤트 콜백
1대1 통화 이벤트 콜백은 1대1 통화가 끝났을 때 호출됩니다. 애플리케이션은 통화 이벤트를 이용해 아래와 같은 작업을 수행할 수 있습니다.
- 통화 로그 남기기
- 통화 상태 확인 (예: 통화가 정상적으로 끝났는지)
- 통계 데이터 수집
메서드와 URI
- 메서드: GET
- URI:
{on_call_evt_cb_url}
쿼리 파라미터
| 파라미터 | 데이터 유형 | Null 허용 | 설명 | 예시 |
|---|---|---|---|---|
sid | String | N | 세션 ID (UUID 형식). 이를 이용해 통화를 식별할 수 있습니다. 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 |
stid | String | Y | Deprecated. PlanetKit의 makeCall()을 호출했을 때 전달된 애플리케이션 데이터 | 애플리케이션이 생성 |
setup_time | Long | N | 통화가 생성된 시각(초) | 0 |
start_time | Long | N | 통화가 시작된 시각(초) | 0 |
end_time | Long | N | 통화가 종료된 시각(초) | 0 |
duration | Integer | N | 통화 지속 시간(초). end_time - start_time. 통화가 실패하면 0입니다. | 30 |
srcip | String | N | 발신자 IP 주소 | 1.2.3.4 |
dstip | String | N | 착신자 IP 주소 | 1.2.3.3 |
terminate | Integer | N | Q.850 원인 코드(cause code). duration이 0보다 크면 이 값은 16(Normal)이 됩니다. 통화 해제 이유를 참고하세요. | 16 |
rel_code | Integer | N | 통화의 상세 해제 코드. 플랫폼 내에서 통화 해제 사유를 추적하는 데 사용합니다. 통화 해제 이유를 참고하세요. | 2 |
rel_code_str | String | N | 통화의 상세 해제 메시지. 플랫폼 내에서 통화 해제 사유를 추적하는 데 사용합니다. 통화 해제 이유를 참고하세요. | CANCEL |
user_rel_code | String | Y | 애플리케이션이 정의한 통화 해제 코드. 통화 해제 이유를 참고하세요. | |
billing_sec | Integer | N | 사용자에게 요금이 청구되는 통화 시간(초 단위, 밀리초 이하는 올림 처리) 참고: 통화 연결 상태에 따라, 청구되는 통화 시간은 통화 지속 시간( duration)보다 적을 수 있습니다. | 25 |
rc_idc | String | N | 발신자를 처리한 IDC를 나타냅니다. ISO 3166-1 alpha-2 code 포맷을 사용하며 모두 대문자입니다. | KR |
disconnect_reason | Integer | N | 통화 종료 이유. 자세한 내용은 통화 종료 이유를 참고하세요. | 1001 |
releaser_type | Integer | N | 통화 종료 소스의 유형. 자세한 내용은 통화 종료 소스를 참고하세요. | 1 |
app_svr_data | String | Y | PlanetKit의 makeCall()을 호출했을 때 전달된 애플리케이션 데이터.자세한 내용은 클라이언트 플랫폼별 앱 서버 데이터 가이드를 참조하세요. - Android - iOS/macOS - Windows - Web 참고: 이 파라미터는 stid와 동일한 데이터를 전달합니다. | 애플리케이션이 생성 |
예제
# Let's suppose on_call_evt_cb_url is
# http://sample.server.com:20200/call_event
# LINE Planet server will send a request to on_call_evt_cb_url as follows.
GET http://sample.server.com:20200/call_event?
sid=6364e8b3-bdac-436e-9631-0bce2498ce0c&
type=V&
from_user_id=9286&
from_service_id=caller-service-id&
to_user_id=2809&
to_service_id=callee-service-id&
setup_time=1582527400&
start_time=1582527404&
end_time=1582527434&
duration=30&
terminate=16&
srcip=1.2.3.4&
dstip=1.2.3.5&
stid=voip.next&
rel_code=1&
rel_code_str=NORMAL&
billing_sec=25&
rc_idc=KR&
disconnect_reason=1001&
releaser_type=1&
app_svr_data=appSvrData