快速开始

欢迎使用 SolisCloud 开发者平台。通过开发者平台，您可以接入 SolisCloud 的电站和设备数据。

当前开通方式

开发者平台注册功能尚未上线，当前所有 API 权限开通均需联系销售对接开通，完成资质审核后即可获取开发者密钥与接口调用权限。

客户类型

当前使用 API 的客户分为两类，开通流程和授权方式不同：

类型	适用场景	云平台账号	授权方式
锦浪云用户（业主/安装商）	在 SolisCloud 拥有可登录账号，拥有归属的电站和设备	有独立账号	面向云平台用户授权（HMAC 签名）
VPP 服务商 / 第三方	在 SolisCloud 无登录账号，需经业主 OAuth2.0 授权	无独立账号	第三方授权（OAuth2.0）

---

第一步：申请 API 使用权限

如需申请 SolisCloud 开放 API 接口权限，请联系我方销售对接开通，完成资质审核后即可获取开发者密钥与接口调用权限。

第三方服务商需额外下载并填写申请材料：Application Materials for SolisCloud API Activation.xlsx，随申请一并提交。

---

第二步：完成开通 — 获取凭证

锦浪云用户（业主 / 安装商）

开通成功后，登录 SolisCloud WEB 端自行获取凭证：

1. 登录 SolisCloud WEB 端：https://www.soliscloud.com
2. 进入 服务 → API 管理 → 立即开通
3. 获取 KeyID 和 KeySecret，用于后续 HMAC-SHA1 签名认证

提示

KeySecret 请妥善保管，若泄露可在同一页面重置。

VPP 服务商 / 第三方

开通成功后，需联系电站业主进行 OAuth2.0 授权：

1. 向电站业主发起 OAuth2.0 授权请求
2. 业主在 SolisCloud 上完成授权后，获取 Access Token，用于后续 API 调用

---

第三步：调用接口

锦浪云用户

使用 KeyID + KeySecret 生成自定义 HMAC-SHA1 签名，调用数据获取、设备控制等 API。

流程：获取 API Key → 生成 HMAC-SHA1 签名 → 调用 API

详见 授权方式

VPP 服务商 / 第三方

使用 OAuth2.0 Access Token 调用数据获取、设备控制等 API。

流程：获取 Access Token → 携带 Bearer Token → 调用 API → 刷新 Token

详见 授权方式

注意

面向云平台用户授权接口不支持 OAuth2.0。如需使用 OAuth2.0，请使用第三方授权方式对应的接口。

---

第三方服务商设备控制建议

控制接口优先级

1. 优先推荐使用 /api/control_device/strategySetting 接口下发指令（策略下发）
2. 如无法满足需求，可使用 /api/control_device/control 接口进行辅助控制
3. 如通用数据转发方式仍无法满足需求，请将需求反馈至对接团队

---

文档对照表

客户类型	数据获取文档	设备控制文档	电站管理	实时数据	授权方式
锦浪云用户（业主/安装商）	数据获取	设备控制	电站管理	实时数据转发	HMAC 签名
VPP 服务商 / 第三方	数据获取	设备控制	不支持	实时数据转发	OAuth2.0

---

未来规划

开发者平台注册功能上线后：

• 支持在线注册账号和创建应用
• 所有相关信息可在网站页面上查看
• 基于 cid 的控制方式将逐步废弃
• 开通流程将更加自动化

---