定义
RESTful API 是遵循 REST（Representational State Transfer）架构风格的 HTTP 接口，采用资源导向的 URL、标准 HTTP 方法（GET、POST、PUT、DELETE）与 JSON 格式数据交换。在国际物联网云平台（ICMP）中，RESTful API 与 Swagger/OpenAPI、API Gateway、OAuth2 配合，支持卡管理、用量查询、计费、激活/暂停等核心能力，是客户系统与平台集成的主要方式。
工作原理
RESTful API 将业务能力抽象为资源（如 /sims、/usage、/invoices），通过 HTTP 方法表达操作意图。客户通过 API Gateway 调用 API，需携带 API Key 或 OAuth2 Token 完成鉴权。Gateway 负责限流、路由、日志记录，请求转发至后端 BSS/OSS 处理。平台通常提供 Swagger 文档与 SDK，降低集成门槛。异步操作（如批量激活）可结合 Event Subscription 或 Webhook 回调通知结果。
应用场景
典型场景包括：SIM 生命周期管理——激活、暂停、恢复、Decommissioning；用量与计费——查询实时用量、历史 CDR、Usage Aggregation 报表；配置管理——PLMN Selection、Preferred Network、APN 等；自动化运维——客户系统根据用量、告警自动触发 Quota 调整、Suspension；与 Reseller 系统集成——渠道商将 API 集成至自有 Portal，实现自动化订购与客户管理。
在 ICMP 中的实践
达希物联 ICMP 的 RESTful API 覆盖连接管理全生命周期，支持 SIM 管理、用量查询、计费、PLMN Selection、Event Subscription 等。API 经 API Gateway 统一入口，支持 OAuth2 与 API Key 鉴权，具备限流与 Audit Trail 能力。提供 Swagger 文档与多语言 SDK，客户可快速集成。结合 TLS 加密与 Data Residency 策略，保障跨境场景下的接口安全与合规。