呼叫管理 API 文档
这些端点允许您检索您的 未接来电, 已接听来电， 和 拨出电话 从 SMSMobileAPI 移动应用同步到您的仪表板 + API。
重要提示：如果移动应用在后台运行，手机系统可能会在同步之间设置延迟（通常最多约 10 分钟）。如有需要，您可以随时打开应用手动同步。
需要帮助吗？ api@smsmobileapi.com
快速入门
基本 URL
得到 https://api.smsmobileapi.com
以下所有端点均已记录为 得到 请求。替换 您的 API 密钥 使用您的真实密钥（请勿公开分享）。
示例
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=17000000000000&date_to_ms=1700864000000
验证
呼叫管理端点使用以下方式进行身份验证 apikey 查询参数。
订阅验证： 传入/传出端点会验证您的 API 密钥并检查您的订阅有效性（dateLimit >= CURDATE()如果过期，您将收到 api_expired.
共同概念
分页
使用 限制 和 抵消 对结果进行分页显示。
时间戳
- 通话日期（毫秒） 是 UNIX 时间戳 毫秒.
- 调用日期时间_UTC 存储为 UTC 日期时间字符串（数据库字段）。
- 对于未接来电，API 返回格式化的 日期 字符串（由毫秒值派生而来）。
搜索
- 未接来电： 搜索 匹配号码或名称。
- 收发： q 比赛 电话号码 或者 缓存名称.
排序（仅限收件/发件）
排序由……控制 排序方式 + 排序目录 （仅限白名单字段）。未接来电始终按最新排序。
错误
| HTTP | 示例错误 | 意义 |
|---|---|---|
| 400 | {"成功":false,"错误":"缺少 API 密钥"} | 缺失或为空 apikey. |
| 403 | {"成功":false,"错误":"无效的apikey"} | 未找到/无法识别API密钥。 |
| 403 | {"成功":false,"错误":"api_expired"} | 您的订阅已过期（日期限制 （指今天之前）。 |
| 500 | {"成功":false,"错误":"服务器错误","详情":"..."} | 服务器错误（数据库、SQL、异常）。 |
注意：未接来电端点还可以返回类似这样的消息 缺少 API 密钥 或者，根据具体情况，可能是 SQL 准备错误。
未接来电列表
从移动设备中检索已同步的未接来电。
端点
得到 https://api.smsmobileapi.com/call/missed/list/
查询参数
| 范围 | 类型 | 描述 |
|---|---|---|
| apikey | 细绳 | 必需的 您的API密钥已绑定到手机。 |
| 抵消 | 整数 | 选修的 分页偏移量（默认值：） 0). |
| 限制 | 整数 | 选修的 最大行数（默认值： 100， 最大限度： 500). |
| 搜索 | 细绳 | 选修的 按编号或名称搜索（SQL LIKE）。 |
| 开始日期 | YYYY-MM-DD | 选修的 从今天（00:00:00）开始筛选。 |
| 日期结束 | YYYY-MM-DD | 选修的 筛选截至今日（23:59:59）。 |
来电列表
从移动设备检索已同步的来电。
端点
得到 https://api.smsmobileapi.com/call/incoming/list/
查询参数
| 范围 | 类型 | 描述 |
|---|---|---|
| apikey | 细绳 | 必需的 您的 API 密钥（已通过订阅验证）。 |
| 限制 | 整数 | 选修的 每页行数（默认值：） 50， 最大限度： 200). |
| 抵消 | 整数 | 选修的 分页偏移量（默认值：） 0). |
| 排序方式 | 细绳 | 选修的 允许： 通话日期（毫秒） 调用日期时间_UTC duration_sec 电话号码 创建于 缓存名称 地理位置 |
| 排序目录 | 升序|降序 | 选修的 默认： 描述. |
| date_from_ms | 整数（毫秒） | 选修的 筛选条件 call_date_ms >= date_from_ms. |
| 日期到毫秒 | 整数（毫秒） | 选修的 筛选条件 call_date_ms <= date_to_ms. |
| q | 细绳 | 选修的 搜索 电话号码 或者 缓存名称 （喜欢）。 |
拨出电话 - 列表
从移动设备检索已同步的拨出电话。
端点
得到 https://api.smsmobileapi.com/call/outgoing/list/
查询参数
与来电相同的参数和行为。
| 范围 | 类型 | 描述 |
|---|---|---|
| apikey | 细绳 | 必需的 您的 API 密钥（已通过订阅验证）。 |
| 限制 | 整数 | 选修的 每页行数（默认值：） 50， 最大限度： 200). |
| 抵消 | 整数 | 选修的 分页偏移量（默认值：） 0). |
| 排序方式 | 细绳 | 选修的 允许： 通话日期（毫秒） 调用日期时间_UTC duration_sec 电话号码 创建于 缓存名称 地理位置 |
| 排序目录 | 升序|降序 | 选修的 默认： 描述. |
| date_from_ms | 整数（毫秒） | 选修的 筛选条件 call_date_ms >= date_from_ms. |
| 日期到毫秒 | 整数（毫秒） | 选修的 筛选条件 call_date_ms <= date_to_ms. |
| q | 细绳 | 选修的 搜索 电话号码 或者 缓存名称 （喜欢）。 |
未接来电字段
| 场地 | 类型 | 描述 |
|---|---|---|
| 成功 | 布尔值 | 请求状态。 |
| 抵消 | 整数 | 返回分页偏移量。 |
| 限制 | 整数 | 返回分页限制。 |
| 数数 | 整数 | 返回的行数 数据. |
| 数据 | 大批 | 未接来电列表。 |
| 数据[].数字 | 细绳 | 来电电话号码。 |
| 数据[].名称 | 细绳 | 缓存的联系人姓名（可能为空）。 |
| 数据[].日期 | 细绳 | 从毫秒时间戳导出的格式化日期时间字符串。 |
收发字段
| 场地 | 类型 | 描述 |
|---|---|---|
| 成功 | 布尔值 | 请求状态。 |
| apikey | 细绳 | API 返回（您的密钥）。 |
| 限制 | 整数 | 每页返回的行数。 |
| 抵消 | 整数 | 返回分页偏移量。 |
| 排序方式 | 细绳 | 应用排序字段。 |
| 排序目录 | 细绳 | 应用排序方向。 |
| 过滤器 | 目的 | 回声滤波器（date_from_ms, 日期到毫秒, q). |
| 数数 | 整数 | 返回的行数 行. |
| 行 | 大批 | 通话记录。 |
| rows[].phone_number | 细绳 | 电话号码。 |
| rows[].cached_name | 字符串|null | 缓存的联系人姓名（可以为空）。 |
| rows[].call_date_ms | 整数 | 调用时间戳（以毫秒为单位）。 |
| rows[].call_datetime_utc | 细绳 | UTC 日期时间字段（数据库）。 |
| rows[].duration_sec | 整数 | 持续时间（秒）。 |
| rows[].geo_location | 字符串|null | 地理位置标签（可以为空）。 |
| rows[].created_at | 细绳 | 服务器插入时间戳。 |
English 
French 
German 
Spanish 
Portuguese 
Russian 
Finnish 
Japanese 
Chinese 
Vietnamese 
Dutch 
Greek 
Arabic 
Danish 
Italian 
Ukrainian