奥升充电｜互联互通协议解析（1）——平台认证

获取token

1. 接口描述

该接口用于交换互联互通业务接口的token，有效期为30分钟。

• 请求Method：POST
• 请求URL：query_token
• 请求参数：

参数名称	类型	必填	说明
OperatorID	String	是	运营商标识，由组织方分配
Data	String	是	业务数据加密后的密文（AES加密）
TimeStamp	String	是	时间戳，格式：yyyyMMddHHmmss
Seq	String	是	交易流水号，格式：0000+yyyyMMddHHmmss
Sig	String	是	签名，计算规则见下文

• 返回参数：

参数名称	类型	必填	说明
Ret	Int	是	0：成功；其他：失败
Msg	String	是	错误描述
Data	String	否	业务数据密文（AES加密），解密后包含 Token 等信息
Sig	String	是	签名

2. 注意事项

1. OperatorID：请使用组织方分配的唯一运营商标识。
2. Data加密：采用 AES-128-CBC 模式，PKCS#7 填充。密钥（OperatorSecret）和初始化向量（DataSecretIV）由组织方提供。
3. Sig签名：计算公式为 Sig = MD5(OperatorID + Data + TimeStamp + Seq + SigSecret)。SigSecret 由组织方提供。
4. Token使用：获取到的 Token 需在后续所有业务接口的 HTTP Header 中携带，字段名为 Authorization，值为 Bearer {Token}。

3. 接口示例

请求示例 (JSON)

{
  "OperatorID": "123456789",
  "Data": "U2FsdGVkX1+...",
  "TimeStamp": "20240501120000",
  "Seq": "000020240501120000",
  "Sig": "ABCDEF123456..."
}

返回示例 (JSON)

{
  "Ret": 0,
  "Msg": "Success",
  "Data": "U2FsdGVkX1+...",
  "Sig": "123456ABCDEF..."
}

参考标准

• 《电动汽车充换电服务信息交换》系列标准

相关链接

• 奥升充电｜互联互通协议解析（2）——公共信息交换规范
• 奥升充电｜互联互通协议解析（3）——业务信息交换规范
• 奥升充电｜互联互通协议解析（4）——常见问题