음성 통화 목록 조회

사용자의 통화 목록을 조회할 수 있습니다.
조회 정렬 기준은 생성일 내림차순입니다.

다음 페이지가 있을 경우 응답 데이터에 'next' 정보가 전달됩니다. 응답에서 받은 'next' 값을 사용하여 다음 목록을 조회 할 수 있습니다. 다음 페이지 조회 시, 'next' 값만 전달하면 됩니다.

GET v1/voice/users/{user_id}/calls

Parameters

Request

GET /v1/voice/users/user_1/calls?limit=20
GET /v1/voice/users/user_1/calls?limit=20&record=true
GET /v1/voice/users/user_1/calls?next={Next Key}

Response

200 success

{
  "calls": [
    {
      "call_id": "Call ID",
      "type": "inapp",  // 통화 타입
      "from": { // 발신자 정보
        "user": {
          "user_id": "User ID",
          "name": "User Name",
          "profile_url": "User Profile URL",
          "meta": {},
          "created_at": 1658977173917,
          "updated_at": 1658977173917
        },
        "duration": 38  // 발신자 통화 사용 시간
      },
      "to": { // 수신자 정보
        "user": {
          "user_id": "User ID",
          "name": "User Name",
          "profile_url": "User Profile URL",
          "meta": {},
          "created_at": 1658977173917,
          "updated_at": 1658977173917
        },
        "duration": 32  // 수신자 통화 사용 시간
      },
      "status": "hangup", // 통화 상태
      "start_at": 1668661352000, // 통화 시작 시간
      "end_at": 1668661368000,  // 통화 종료 시간
      "created_at": 1658977173917,
      "updated_at": 1658977173917,
      "record": { // 녹음 파일 존재시
        "type": "audio/mpeg",
        "size": 129581,
        "duration": 38  // 총 통화 녹음 시간
      }
    }
    ,,,
  ],
  "next": "Next Key", // 다음 페이지 키
}