Đọc bản ghi cuộc gọi của tài khoản

Truy xuất bản ghi cuộc gọi của tài khoản

Đọc các bản ghi cuộc gọi đến hoặc đi của tài khoản API của bạn. Các bản ghi này chứa thông tin riêng tư về cuộc gọi và tính cước. Chỉ xử lý chúng trong các quy trình phía máy chủ được cấp quyền, đồng thời tránh ghi nhật ký hoặc chia sẻ khi không cần thiết.

Điểm cuối cũ này hiện có khoảng ngày mặc định cố định và không hỗ trợ phân trang. Hãy dùng quy trình xem lịch sử cuộc gọi/xuất dữ liệu trên cổng thông tin khi cần kỳ báo cáo khác hoặc xuất lượng lớn dữ liệu lịch sử; các tham số ngày tùy chỉnh của điểm cuối này không hoạt động đáng tin cậy.

Yêu cầu

Xác thực qua HTTPS bằng tài khoản API đã được kích hoạt, từ địa chỉ IP nguồn được phép của tài khoản đó. Ví dụ sử dụng thông tin xác thực trong các biến môi trường. Các yêu cầu trong khoảng thời gian mặc định được hỗ trợ không cần phần thân.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/cdrs

Dùng chính xác giá trị chỉ hướng inbound hoặc outbound như trên. Nhánh xử lý cuộc gọi đi không triển khai bộ lọc theo từng số điện thoại. Thêm số điện thoại vào đường dẫn đó không thu hẹp kết quả cuộc gọi đi.

Khoảng thời gian báo cáo mặc định

Truy vấn bắt đầu lúc nửa đêm của ngày cách hôm nay 30 ngày theo lịch trên máy chủ và kết thúc lúc nửa đêm bắt đầu ngày hôm nay. Vì vậy, kết quả không bao gồm phần còn lại của ngày hiện tại. Đây không phải khoảng thời gian trượt 720 giờ kết thúc tại thời điểm hiện tại.

Cách triển khai hiện tại không hỗ trợ đáng tin cậy các trường biểu mẫu date_from/date_to: khi cung cấp ngày tùy chỉnh, các biến xác định năm phân vùng không được gán giá trị. Không dùng các trường đó cho báo cáo trong môi trường vận hành thực tế. Ngày trong chuỗi truy vấn và các tham số phân trang cũng chưa được triển khai làm phương án thay thế.

Phản hồi

Chỉ minh họa một số trường được chọn của cuộc gọi đến; đây là dữ liệu giả định, không phải toàn bộ bản ghi được trả về.

{
  "status": {
    "code": "200",
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "callerid": "12025550124",
      "disposition": "ANSWERED",
      "billseconds": "60",
      "billcost": "0.0100",
      "callsid": "11111111111111111111111111111111",
      "date_created": "2026-10-01 12:00:00 UTC"
    }
  ]
}

response là một danh sách. Cấu trúc bao ngoài phản hồi dùng chung có thể chứa status.results để biểu thị số hàng. Mã kết quả có thể là chuỗi. Khi không có bản ghi, kết quả dùng mã API 404 kèm thông báo No entries found, thay vì trả về một danh sách rỗng với trạng thái thành công.

Các trường của bản ghi

Điểm cuối không áp dụng thứ tự sắp xếp hay phân trang rõ ràng. Không mặc định rằng kết quả mới nhất xuất hiện trước, thứ tự hàng ổn định hoặc có con trỏ đồng bộ tăng dần. Các trường tính cước được trả về là dữ liệu cuộc gọi đã lưu, không phải báo giá cho một cuộc gọi trong tương lai.

Lỗi và giới hạn khi lập báo cáo

Đọc cả trạng thái HTTP và status.code/status.msg trong JSON. Khi không có bản ghi trong tài khoản/khoảng thời gian đã chọn, hệ thống trả về mã API 404. Các yêu cầu xác thực và hạn chế về IP nguồn cũng được áp dụng. Báo cáo lớn không phân trang hoặc yêu cầu ngày tùy chỉnh không đáng tin cậy có thể thất bại; truy vấn lặp lại toàn bộ bảng không phải là chiến lược xuất dữ liệu tăng dần.

Trình xử lý đã được rà soát chứa các truy vấn đọc và không trừ tiền tài khoản hay khởi tạo cuộc gọi. Một bản ghi được trả về không chứng minh rằng có người đã trả lời; hãy diễn giải trạng thái kết quả và thời lượng đã lưu phù hợp với nhu cầu báo cáo của bạn.