Tài liệu API quản lý cuộc gọi
Các điểm cuối này cho phép bạn truy xuất thông tin của mình. Cuộc gọi nhỡ, Cuộc gọi đến đã được trả lời, Và Cuộc gọi đi Đã đồng bộ hóa từ ứng dụng di động SMSMobileAPI vào bảng điều khiển + API của bạn.
Quan trọng: Nếu ứng dụng di động chạy ngầm, hệ thống điện thoại có thể gây ra độ trễ (thường lên đến ~10 phút) giữa các lần đồng bộ hóa. Bạn luôn có thể mở ứng dụng để đồng bộ hóa thủ công nếu cần.
Hướng dẫn nhanh
URL cơ sở
KHÓA_API_CỦA_BẠN Với khóa thật của bạn (đừng chia sẻ công khai).
Ví dụ
GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY
GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc
GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&q=3247&date_from_ms=1700000000000&date_to_ms=1700864000000
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.
dateLimit >= CURDATE()Nếu hết hạn, bạn sẽ nhận được api_expiredĐiểm cuối xử lý cuộc gọi nhỡ có thể trả về thông báo chung "Thiếu apikey" / lỗi máy chủ tùy thuộc vào điều kiệ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_mslà 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àyChuỗi ký tự (được suy ra từ giá trị mili giây).
Tìm kiếm
- Cuộc gọi nhỡ:
tìm kiếmPhù hợp với số hoặc tên. - Cuộc gọi đến/Đi:
qKhớp với số điện thoại hoặc tên được lưu trong bộ nhớ cache.
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
| HTTP | Ví dụ lỗi | Nghĩa |
|---|---|---|
| 400 | {"success":false,"error":"missing_apikey"} |
Thiếu hoặc trống con khỉ. |
| 403 | {"success":false,"error":"invalid_apikey"} |
Không tìm thấy/không nhận dạng được khóa API. |
| 403 | {"success":false,"error":"api_expired"} |
Gói đăng ký của bạn đã hết hạn (Giới hạn ngày (trước ngày hôm nay). |
| 500 | {"success":false,"error":"server_error","detail":"..."} |
Lỗi máy chủ (cơ sở dữ liệu, SQL, ngoại lệ). |
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
| Tham số | Kiểu | Sự miêu tả |
|---|---|---|
Yêu cầucon khỉ |
sợi dây | Mã API của bạn được liên kết với điện thoại di động. |
Không bắt buộcbù lại |
số nguyên | Vị trí phân trang (mặc định: 0). |
Không bắt buộcgiới hạn |
số nguyên | Số hàng tối đa trả về (mặc định: 100, tối đa: 500). |
Không bắt buộctìm kiếm |
sợi dây | Tìm kiếm theo số hoặc tên (SQL LIKE). |
Không bắt buộcngày bắt đầu |
YYYY-MM-DD | Lọc dữ liệu từ ngày này (00:00:00). So sánh với dấu thời gian tính bằng mili giây đã lưu. |
Không bắt buộcngày_kết thúc |
YYYY-MM-DD | Lọc dữ liệu đến ngày hôm nay (23:59:59). So sánh với dấu thời gian tính bằng mili giây đã lưu. |
Sắp xếp
Đã sửa: mới nhất trước (SẮP XẾP THEO ngày tháng MÔ TẢ).
Ví dụ về yêu cầu
GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY&limit=100&offset=0&search=John&date_start=2026-02-01&date_end=2026-02-24
Ví dụ về câu trả lời
{ "success": true, "offset": 0, "limit": 100, "count": 2, "data": [ { "number": "+123470000000", "name": "John Doe", "date": "2026-02-24 12:49:39" }, { "number": "+123471111111", "name": "", "date": "2026-02-24 11:12:09" } ] }
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
| Tham số | Kiểu | Sự miêu tả |
|---|---|---|
Yêu cầucon khỉ |
sợi dây | Khóa API của bạn. Đã được xác thực dựa trên gói đăng ký (Giới hạn ngày). |
Không bắt buộcgiới hạn |
số nguyên | Số hàng trên mỗi trang (mặc định: 50, tối thiểu 1, tối đa 200). |
Không bắt buộcbù lại |
số nguyên | Vị trí phân trang (mặc định: 0). |
Không bắt buộcsắp xếp theo |
sợi dây |
Sắp xếp trường (mặc định: ngày gọi_ms). Cho phép:
ngày gọi_ms, call_datetime_utc, thời lượng_giây, số_điện_thoại,
created_at, tên_được_lưu_chứa, vị trí địa lý.
|
Không bắt buộcthư mục sắp xếp |
tăng dần|giảm dần | Hướng sắp xếp (mặc định: mô tả). |
Không bắt buộcngày_từ_ms |
int (ms) | Lọc theo vị trí call_date_ms >= date_from_ms. |
Không bắt buộcngày_đến_ms |
int (ms) | Lọc theo vị trí call_date_ms <= date_to_ms. |
Không bắt buộcq |
sợi dây | Tìm kiếm (THÍCH) trên số_điện_thoại hoặc tên_được_lưu_chứa. |
Ví dụ về yêu cầu
GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=100&offset=0&sort_by=call_date_ms&sort_dir=desc&q=3247
Ví dụ về câu trả lời
{ "success": true, "apikey": "YOUR_API_KEY", "limit": 100, "offset": 0, "sort_by": "call_date_ms", "sort_dir": "desc", "filters": { "date_from_ms": null, "date_to_ms": null, "q": "+12347" }, "count": 2, "rows": [ { "phone_number": "+123470000000", "cached_name": "Matteo Css", "call_date_ms": 1761233379000, "call_datetime_utc": "2026-02-23 12:49:39", "duration_sec": 440, "geo_location": "Belgique", "created_at": "2026-02-24 04:14:38" } ] }
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.
| Tham số | Kiểu | Sự miêu tả |
|---|---|---|
Yêu cầucon khỉ |
sợi dây | Khóa API của bạn. Đã được xác thực dựa trên gói đăng ký (Giới hạn ngày). |
Không bắt buộcgiới hạn |
số nguyên | Số hàng trên mỗi trang (mặc định: 50, tối đa 200). |
Không bắt buộcbù lại |
số nguyên | Vị trí phân trang (mặc định: 0). |
Không bắt buộcsắp xếp theo |
sợi dây |
Mặc định ngày gọi_ms. Cho phép:
ngày gọi_ms, call_datetime_utc, thời lượng_giây, số_điện_thoại,
created_at, tên_được_lưu_chứa, vị trí địa lý.
|
Không bắt buộcthư mục sắp xếp |
tăng dần|giảm dần | Mặc định mô tả. |
Không bắt buộcngày_từ_ms |
int (ms) | Lọc theo dấu thời gian này (ms). |
Không bắt buộcngày_đến_ms |
int (ms) | Lọc theo mốc thời gian này (ms). |
Không bắt buộcq |
sợi dây | Tìm kiếm trên số_điện_thoại hoặc tên_được_lưu_chứa. |
Ví dụ về yêu cầu
GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=duration_sec&sort_dir=desc&date_from_ms=1700000000000&date_to_ms=1700864000000
Ví dụ về câu trả lời
{ "success": true, "apikey": "YOUR_API_KEY", "limit": 50, "offset": 0, "sort_by": "duration_sec", "sort_dir": "desc", "filters": { "date_from_ms": "1700000000000", "date_to_ms": "1700864000000", "q": null }, "count": 1, "rows": [ { "phone_number": "+123490000000", "cached_name": null, "call_date_ms": 1761231000000, "call_datetime_utc": "2026-02-23 12:10:00", "duration_sec": 120, "geo_location": "Belgique", "created_at": "2026-02-24 04:14:37" } ] }
Trường cuộc gọi nhỡ
| Cánh đồng | Kiểu | Sự miêu tả |
|---|---|---|
thành công | boolean | Trạng thái yêu cầu. |
bù lại | số nguyên | Đã trả về vị trí offset của trang. |
giới hạn | số nguyên | Đã trả về giới hạn phân trang. |
đếm | số nguyên | Số lượng hàng được trả về trong dữ liệu. |
dữ liệu | mảng | Danh sách các cuộc gọi nhỡ. |
data[].number | sợi dây | Số điện thoại người gọi. |
data[].name | sợi dây | Tên liên hệ được lưu trong bộ nhớ cache (có thể trống). |
data[].date | sợi dây | Chuỗi ngày giờ được định dạng, được tạo ra từ dấu thời gian tính bằng mili giây. |
Trường đến/đi
| Cánh đồng | Kiểu | Sự miêu tả |
|---|---|---|
thành công | boolean | Trạng thái yêu cầu. |
con khỉ | sợi dây | Được API (khóa của bạn) phản hồi lại. |
giới hạn | số nguyên | Số dòng trả về trên mỗi trang. |
bù lại | số nguyên | Đã trả về vị trí offset của trang. |
sắp xếp theo | sợi dây | Áp dụng trường sắp xếp. |
thư mục sắp xếp | sợi dây | Hướng sắp xếp đã được áp dụng. |
bộ lọc | sự vật | Bộ lọc phản xạ (ngày_từ_ms, ngày_đến_ms, q). |
đếm | số nguyên | Số lượng hàng được trả về trong hàng. |
hàng | mảng | Danh sách cuộc gọi. |
hàng[].số_điện_thoại | sợi dây | Số điện thoại. |
rows[].cached_name | chuỗi|null | Tên liên hệ được lưu trong bộ nhớ cache (có thể là null). |
hàng[].ngày_cuộc_gọi_ms | số nguyên | Thời gian thực hiện cuộc gọi tính bằng mili giây. |
hàng[].call_datetime_utc | sợi dây | Trường thời gian UTC (cơ sở dữ liệu). |
hàng[].thời lượng_giây | số nguyên | Thời lượng tính bằng giây. |
hàng[].vị trí địa lý | chuỗi|null | Nhãn vị trí địa lý (có thể là null/rỗng). |
rows[].created_at | sợi dây | Thời điểm chèn dữ liệu vào máy chủ. |
