跳转到主要内容

格式

所有错误响应都采用以下格式:
{
  "error": {
    "code": "LOCATION_NOT_FOUND",
    "message": "Location 123 was not found for the provided tenant",
    "requestId": "b1f6e6b0-1234-4abc-9def-000000000000"
  }
}
requestId 在每个请求中都是唯一的 —— 在就具体错误联系 RiDERgy 支持团队时,请附上该 ID。

错误代码

CodeHTTP status含义
UNAUTHORIZED401API 密钥缺失、无效、未激活或已过期。
FEATURE_NOT_ENABLED403您的租户未启用 Energy Management API。
INVALID_REQUEST_BODY400请求正文缺少必填字段、JSON 格式错误,或未通过校验(例如 limitKw <= 0endTime <= startTimeendTime 早于当前时间、priority 超出 0-10 范围)。
TARGET_INACTIVE400目标位置被标记为非活动状态。
LOCATION_NOT_FOUND404您的租户下不存在具有给定 locationId 的位置。
CHARGER_NOT_FOUND404您的租户下不存在具有给定 controllerUuid/connectorId 的连接器。
CLUSTER_NOT_FOUND404您的租户下不存在具有给定 clusterId 的集群。
CLUSTER_INACTIVE400该集群的 statusINACTIVE
CLUSTER_EMPTY400该集群没有成员位置。
NOT_FOUND404该路径/方法组合不是有效的端点。
INTERNAL_ERROR500服务器端发生意外错误。