同步全量SIM信息

适用场景

适用于企业客户需要获取其名下全量 SIM 卡的信息（截至当日 UTC 0 点）。

必要条件

调用方为企业客户；
请求方法必须为 GET；
查询参数可选择以下方式之一：
- 按分页查询：使用 page_no（默认第1页）；
- 按指定 SIM 列表查询：使用 sim_ids（最多100个）。
- 按出库起止时间查询：使用 shipped_after 和 shipped_before（ shipped_before 时间不能早于 shipped_after ）同时支持 page_no

注意事项

接口返回的数据截止于请求当日的 00:00（UTC+0），而非实时数据。例如：8月8日14:00（UTC+0）发起请求，返回的是截至8月8日00:00的数据；
若当日数据尚未准备就绪，接口将自动返回前一日 00:00 的数据；
建议在每日 12:00（UTC+8）之后调用，以确保当日数据已完成生成；
使用 sim_ids 时：
- 重复的 SIM ID 在结果中仅返回一条；
- 不存在或非本企业所属的 SIM ID 不会出现在响应中；
已废弃的设备数据不会被返回。

业务规则

所有返回数据基于每日 UTC 0 点，不包含当日 0 点后的变更；
请求时 sim_ids 优先，当 sim_ids 被指定时，API 将仅返回这些 sim_ids 的记录；
请求时 sim_ids 输入个数<=100个；
若仅传 shipped_after ，未传 shipped_before ，则 shipped_before 默认为请求到达服务器当日的 23:59:59 UTC+0；
当请求中传入 shipped_after 时，分页数据按出库时间 shipped_at 升序排列（从早到晚）；
仅当 status = 10 时，响应中才包含 pre_activated_status 字段；
仅支持sphere2系统数据查询。

版本

X-LF-Signature-Type：2.0

SDK API 调用方式

SDK支持版本：暂不支持

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

示例

{
    "data": {
        "pages": 443,
        "page_no": 19,
        "last_updated_at": 1787332229830,
        "list": [
            {
                "sim_id": "89852202306300023442",
                "last_landing_carrier_MCC": "460",
                "last_landing_carrier_MNC": "20",
                "activated_at": 1677654516000,
                "shipped_at": 1677654516000,
                "status": 10,
                "pre_activated_status": 21,
                "lastest_session_started_at": 1685548799000,
                "imei": "860016040008240",
                "current_month_usage": "1073741824",
                "lifespan_usage": "1073741824",
                "sim_type": "Plastic SIM",
                "imsi": [
                    "811000012000182"
                ]
            }
        ]
    },
    "status": {
        "code": "CB-00-0000",
        "message": "成功",
        "detail": "https://developer.linksfield.net/doc-1413557?nav=01GBM770ARR76AXBD5856Z6J6P"
    }
}

🟢200success

适用场景

必要条件

注意事项

业务规则

版本

SDK API 调用方式

请求参数

请求示例代码

返回响应