Tài liệu API quản lý cuộc gọi

Hướng dẫn nhanh

URL cơ sở

Ví dụ

Xác thực

Các thiết bị đầu cuối Quản lý cuộc gọi xác thực bằng cách sử dụng con khỉ tham số truy vấn.

Khái niệm chung

Đánh số trang

Sử dụng giới hạn Và bù lại để phân trang kết quả.

Dấu thời gian

• ngày gọi_ms là dấu thời gian UNIX trong mili giây.
• call_datetime_utc được lưu trữ dưới dạng chuỗi ngày giờ UTC (trường cơ sở dữ liệu).
• Đối với các cuộc gọi nhỡ, API trả về một định dạng được xác định. ngày Chuỗi ký tự (được suy ra từ giá trị mili giây).

Tìm kiếm

• Cuộc gọi nhỡ: tìm kiếm Phù hợp với số hoặc tên.
• Cuộc gọi đến/Đi: q các trận đấu số_điện_thoại hoặc tên_được_lưu_chứa.

Phân loại (Chỉ áp dụng cho thư đến/thư đi)

Việc phân loại được điều khiển bởi sắp xếp theo + thư mục sắp xếp (Chỉ các trường được cho phép). Cuộc gọi nhỡ luôn được sắp xếp theo thứ tự mới nhất trước.

Lỗi

Lưu ý: điểm cuối Cuộc gọi nhỡ cũng có thể trả về các thông báo như sau: Thiếu apikey hoặc các lỗi chuẩn bị câu lệnh SQL tùy thuộc vào tình huống.

Danh sách cuộc gọi nhỡ

Truy xuất các cuộc gọi nhỡ đã được đồng bộ hóa từ thiết bị di động.

Điểm cuối

Tham số truy vấn

Ví dụ về yêu cầu

Ví dụ phản hồi JSON

{ "success": true, "offset": 0, "limit": 100, "count": 3, "data": [ { "number": "+15551230001", "name": "", "date": "2026-03-20 16:12:28" }, { "number": "+15551230002", "name": "Alex Carter", "date": "2026-03-20 16:12:00" }, { "number": "+447700900123", "name": "Taylor Reed", "date": "2026-03-20 15:48:41" } ] }

Giải thích phản hồi

Danh sách cuộc gọi đến

Nhận các cuộc gọi đến đã được trả lời và đồng bộ hóa từ thiết bị di động.

Điểm cuối

Tham số truy vấn

Ví dụ về yêu cầu

Ví dụ phản hồi JSON

{ "success": true, "apikey": "YOUR_API_KEY_HASH", "limit": 50, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": null }, "count": 3, "rows": [ { "phone_number": "+15551230010", "cached_name": "Jordan Blake", "call_date_ms": 1774027779390, "call_datetime_utc": "2026-03-20 17:29:39", "duration_sec": 23, "geo_location": "Canada", "created_at": "2026-03-20 17:46:45" }, { "phone_number": "+15551230011", "cached_name": "Morgan Lee", "call_date_ms": 1774018268663, "call_datetime_utc": "2026-03-20 14:51:08", "duration_sec": 50, "geo_location": "Canada", "created_at": "2026-03-20 14:58:37" }, { "phone_number": "+447700900124", "cached_name": "Sam Parker", "call_date_ms": 1774011205123, "call_datetime_utc": "2026-03-20 12:53:25", "duration_sec": 92, "geo_location": "Canada", "created_at": "2026-03-20 12:59:01" } ] }

Giải thích phản hồi

Danh sách cuộc gọi đi

Truy xuất các cuộc gọi đi đã được đồng bộ hóa từ thiết bị di động.

Điểm cuối

Tham số truy vấn

Các thông số và hoạt động tương tự như cuộc gọi đến.

Ví dụ về yêu cầu

Ví dụ phản hồi JSON

{ "success": true, "apikey": "YOUR_API_KEY_HASH", "limit": 50, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": null }, "count": 3, "rows": [ { "phone_number": "+15551230020", "cached_name": "Casey Morgan", "call_date_ms": 1774025965645, "call_datetime_utc": "2026-03-20 16:59:25", "duration_sec": 15, "geo_location": "Canada", "created_at": "2026-03-20 17:17:58" }, { "phone_number": "+15551230021", "cached_name": "Taylor Brooks", "call_date_ms": 1774023172638, "call_datetime_utc": "2026-03-20 16:12:52", "duration_sec": 556, "geo_location": "Canada", "created_at": "2026-03-20 16:28:38" }, { "phone_number": "+33198765432", "cached_name": "Jamie Carter", "call_date_ms": 1774019040000, "call_datetime_utc": "2026-03-20 15:04:00", } ] }

Giải thích phản hồi

Trường cuộc gọi nhỡ

Trường đến/đi