一、场景概述
API 开放对接是物联网卡管理平台面向企业业务系统的能力开放层，提供标准化 RESTful 接口，供 ERP、CRM、客服系统、自建平台等调用卡管理、套餐、流量、订单、用户等能力，实现业务自动化与系统集成。与运营商对接（平台与运营商底层通信）不同，API 开放是「平台向企业系统开放能力」。
支持 AccessKey/SecretKey 鉴权、请求签名防篡改、IP 白名单、调用限流、调用日志。提供完整 API 文档、多语言 SDK、沙箱环境，企业只需对接平台 API 即可获得全量业务能力，无需关心运营商差异。
二、API 能力分类
卡管理 API
开卡、停复机、套餐变更、卡信息查询、批量操作。支持同步与异步模式，大批量操作可异步回调，满足高并发与批量开卡场景。
套餐与流量 API
套餐列表、套餐订购、流量查询、用量明细。支持按卡、按项目、按时间范围多维度查询，满足用量监控与计费对账需求。
订单与用户 API
订单创建、查询、退款；用户注册、绑卡、权限管理。支持与自有业务系统打通，实现订单-开卡-用户一体化闭环。
安全与文档
AccessKey/SecretKey 鉴权、请求签名防篡改、IP 白名单、调用频率限制。完整 API 文档含请求/响应示例、错误码说明，支持在线调试、Postman 集合及 Java/Python/PHP 等多语言 SDK。
三、接入流程
四、API 开放与运营商对接对比
API 开放与运营商对接是平台的两层能力，核心差异如下：
| 维度 | API 开放 | 运营商对接 |
|---|---|---|
| 对接对象 | 企业业务系统（ERP/CRM/自建平台） | 运营商系统（移动/联通/电信） |
| 核心职责 | 向企业开放平台业务能力 | 平台与运营商底层通信 |
| 企业关注点 | 调用 API 实现卡管理、套餐、流量等自动化 | 无需关心，由平台统一封装 |
| 典型能力 | 开卡、停复机、套餐变更、流量查询、订单管理 | 运营商开卡接口、状态同步、用量拉取 |
企业只需对接平台 API 即可获得全量业务能力，平台负责与运营商通信，屏蔽运营商差异。
五、典型应用场景
- ERP/CRM 集成：企业 ERP、CRM 通过 API 实现卡管理、订单同步，避免人工重复录入，提升运营效率
- 客服系统集成：客服系统调用卡信息查询 API，用户报卡号时快速检索卡状态、套餐、流量，提升服务响应速度
- 自建平台：企业自建物联网管理平台，通过 API 获取卡、套餐、流量等数据，实现定制化展示与操作，满足个性化需求
六、方案价值
达希物联网云平台 API 开放方案帮助企业实现卡管理自动化：系统集成，与 ERP/CRM/客服系统无缝对接，减少人工操作；快速接入，完整文档、多语言 SDK、沙箱环境支持联调验证；安全可控，鉴权、签名、限流、IP 白名单保障调用安全；能力统一，企业只需对接平台 API，无需关心运营商差异。
七、实施建议
建议先用沙箱环境联调验证，通过后再申请生产环境密钥接入。鉴权密钥需妥善保管、定期轮换，限流可按接口、按账号配置防止滥用。调用日志便于问题排查与审计。API 覆盖卡管理、套餐、流量、订单等主要业务场景，与支付集成（支付渠道）配合可实现订单-支付-开卡全流程自动化。