Yêu cầu phát triển tài liệu - SMSMobileAPI
SMSMobileAPI – Tài liệu hướng dẫn về API quản lý cuộc gọi

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.

Ủng hộ: api@smsmobileapi.com

Hướng dẫn nhanh

URL cơ sở

LẤYhttps://api.smsmobileapi.com
Tất cả các điểm cuối bên dưới đều được ghi lại như sau: LẤY yêu cầu. Thay thế 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.

Xác thực đăng ký: Các điểm cuối đến/đi xác thực khóa API của bạn và kiểm tra tính hợp lệ của gói đăng ký (dựa trê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ạnbù 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 Khớ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

LẤYhttps://api.smsmobileapi.com/call/missed/list/

Tham số truy vấn

Tham sốKiểuSự 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

LẤYhttps://api.smsmobileapi.com/call/incoming/list/

Tham số truy vấn

Tham sốKiểuSự 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

LẤYhttps://api.smsmobileapi.com/call/outgoing/list/

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ểuSự 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 đồngKiểuSự miêu tả
thành côngbooleanTrạng thái yêu cầu.
bù lạisố nguyênĐã trả về vị trí offset của trang.
giới hạnsố nguyênĐã trả về giới hạn phân trang.
đếmsố nguyênSố lượng hàng được trả về trong dữ liệu.
dữ liệumảngDanh sách các cuộc gọi nhỡ.
data[].numbersợi dâySố điện thoại người gọi.
data[].namesợi dâyTên liên hệ được lưu trong bộ nhớ cache (có thể trống).
data[].datesợi dâyChuỗ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 đồngKiểuSự miêu tả
thành côngbooleanTrạ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ạnsố nguyênSố dòng trả về trên mỗi trang.
bù lạisố nguyênĐã trả về vị trí offset của trang.
sắp xếp theosợi dâyÁp dụng trường sắp xếp.
thư mục sắp xếpsợi dâyHướng sắp xếp đã được áp dụng.
bộ lọcsự vậtBộ lọc phản xạ (ngày_từ_ms, ngày_đến_ms, q).
đếmsố nguyênSố lượng hàng được trả về trong hàng.
hàngmảngDanh sách cuộc gọi.
hàng[].số_điện_thoạisợi dâySố điện thoại.
rows[].cached_namechuỗi|nullTên liên hệ được lưu trong bộ nhớ cache (có thể là null).
hàng[].ngày_cuộc_gọi_mssố nguyênThời gian thực hiện cuộc gọi tính bằng mili giây.
hàng[].call_datetime_utcsợi dâyTrường thời gian UTC (cơ sở dữ liệu).
hàng[].thời lượng_giâysố nguyênThời lượng tính bằng giây.
hàng[].vị trí địa lýchuỗi|nullNhãn vị trí địa lý (có thể là null/rỗng).
rows[].created_atsợi dâyThời điểm chèn dữ liệu vào máy chủ.
💬 Trò chuyện trực tiếp
💬 Có sẵn trò chuyện trực tiếp
Bạn có thắc mắc hoặc cần hỗ trợ không?
Đội ngũ của chúng tôi luôn sẵn sàng hỗ trợ bạn!

Nhập địa chỉ email của bạn
để giúp chúng tôi theo dõi yêu cầu của bạn:
Bảng điều khiển