할 수 있는 일
진행 중이거나 끝난 통화를 id로 조회해요. 인증한 계정의 원 통화만 조회할 수 있어요. 전환으로 파생된 별도 통화와 포털 테스트 통화는 제외해요.파라미터
결과
성공하면200 OK와 통화 객체가 와요. 별도의 data 봉투는 없어요. 아래 14개 필드는
통화 생성·목록·종료 접수·전환 접수 응답에서도 같은 형태로 쓰여요.
아직 만들어지지 않았거나 제공되지 않는 값은 **
null**이에요. 통화가 끝나도 전사·요약·과금
집계가 아직 반영되지 않았을 수 있어요. summary나 creditCharged가 null이라는 이유로
진행 중이라고 판단하지 말고 status를 확인하세요.
종료 직후에는 상태와 endedAt도 결과 반영을 기다리는 동안 이전 값으로 보일 수 있어요.
종료 요청의 202 응답만으로 종료를 확정하지 말고 상세를 다시 조회하세요.
source와 endReason은 고정된 코드 목록이 아니에요. 새로운 값이 올 수 있으니 알지 못하는
값도 처리할 수 있게 만드세요. 통화 객체에는 상대 전화번호가 포함되지 않아요.
200 예시
공개 상태
이 상태는 통화 결과를 공개 API의 7개 값으로 맞춘 것이에요. 연결 전의 대기·발신은
dialing으로, 연결된 통화는 inProgress로, 상담APP 상담사 연결 대기는
transferring으로 보여요. 통화 전환으로 번호에 넘기는 동안에는
inProgress예요.
통화 중·무응답 사유
발신 결과가 통화 중(busy)이면 공개 status는 failed예요. 무응답(no_answer)이면
noAnswer예요. 이때 종료 사유가 저장되지 않은 경우에만 다음 값을 채워요.
이미 저장된
endReason이 있으면 위 기본값보다 저장된 사유를 우선해요.
busy·no_answer 자체가 공개 status로 오지는 않아요.
취소와 과금
종료 요청으로 취소한 통화는 상대가 받기 전이든 받은 뒤든 공개status가 cancelled로 보여요. 다만 상대가 받은 뒤의 종료는 통화 시간에 따른 과금이
있고, 받기 전 취소는 통화 요금이 부과되지 않아요. 취소 상태만 보고 무료라고 판단하지
말고 startedAt·durationSeconds·creditCharged를 함께 확인하세요.
계정 경계와 오류
없는 id, 형식이 잘못된 id, 다른 계정의 통화는 모두 **404 call_not_found**예요. 다른 계정의
통화가 존재하는지는 알려 주지 않아요. 조회 대상에서 제외한 전환 파생 통화와 테스트 통화도
같은 응답을 받아요.
인증 오류와 그 밖의 처리 오류는 REST 오류를 보세요.