• • companyCode： 企业唯一识别码（用于请求头身份标识）
• • key： 接口签名密钥（仅用于本地签名生成，严禁在网络中明文传输）

• • 密钥应存储在服务器端配置文件或环境变量中，禁止硬编码在客户端代码
• • 定期（建议每季度）审查密钥使用情况，发现异常立即联系官方重置
• • 不同环境（测试/生产）应使用不同的凭证，避免相互影响
• • 限制密钥访问权限，仅核心开发人员知晓，离职时需更换密钥

aiMode=0&batRatedCapacity=1&batRatedChargingPower=1000&customTimes=00:00,12:00,1000&13:00,15:00,-2000&dataTime=2025-06-26&energyMode=2&priceCompany=Germany&time=1732756652&key=2a1891544dbcf8e8b45b36d03187485a

{
  "energyMode": "2",
  "aiMode": "0",
  "customTimes": "00:00,12:00,1000&13:00,15:00,-2000",
  "batRatedCapacity": "1",
  "batRatedChargingPower": "1000",
  "dataTime": "2025-06-26",
  "priceCompany": "Germany"
}

aiMode, batRatedCapacity, batRatedChargingPower, customTimes, dataTime, energyMode, priceCompany

aiMode=0&batRatedCapacity=1&batRatedChargingPower=1000&customTimes=00:00,12:00,1000&13:00,15:00,-2000&dataTime=2025-06-26&energyMode=2&priceCompany=Germany

aiMode=0&batRatedCapacity=1&batRatedChargingPower=1000&customTimes=00:00,12:00,1000&13:00,15:00,-2000&dataTime=2025-06-26&energyMode=2&priceCompany=Germany&time=1732756652&key=2a1891544dbcf8e8b45b36d03187485a

import java.security.MessageDigest;
import java.util.TreeMap;

public class SignGenerator {
    public static String generateSign(TreeMap params, String key) {
        try {
            StringBuilder sb = new StringBuilder();
            // Concatenate business parameters
            for (String paramKey : params.keySet()) {
                if (!paramKey.equals("sign")) {
                    sb.append(paramKey).append("=").append(params.get(paramKey)).append("&");
                }
            }
            // Append time and key
            sb.append("time=").append(params.get("time")).append("&key=").append(key);
            
            // MD5 encrypt and convert to lowercase
            MessageDigest md = MessageDigest.getInstance("MD5");
            byte[] digest = md.digest(sb.toString().getBytes("UTF-8"));
            StringBuilder hexString = new StringBuilder();
            for (byte b : digest) {
                String hex = Integer.toHexString(0xff & b);
                if (hex.length() == 1) hexString.append('0');
                hexString.append(hex);
            }
            return hexString.toString().toLowerCase();
        } catch (Exception e) {
            throw new RuntimeException("Signature generation failed", e);
        }
    }
}

import hashlib
from urllib.parse import urlencode

def generate_sign(params, key):
    """
    Generate API signature
    :param params: Business parameter dict (contains time)
    :param key: Assigned key
    :return: MD5 signature string (lowercase)
    """
    # Exclude sign field, sort by key
    sorted_params = sorted([(k, v) for k, v in params.items() if k != 'sign'])
    # Concatenate parameters
    param_str = '&'.join([f"{k}={v}" for k, v in sorted_params])
    # Append time and key
    sign_str = f"{param_str}&time={params['time']}&key={key}"
    # MD5 encrypt and convert to lowercase
    return hashlib.md5(sign_str.encode('utf-8')).hexdigest().lower()

# Usage example
params = {
    'energyMode': '2',
    'aiMode': '0',
    'customTimes': '00:00,12:00,1000&13:00,15:00,-2000',
    'batRatedCapacity': '1',
    'batRatedChargingPower': '1000',
    'dataTime': '2025-06-26',
    'priceCompany': 'Germany',
    'time': '1732756652'
}
sign = generate_sign(params, '2a1891544dbcf8e8b45b36d03187485a')
print(f"Generated signature: {sign}")

const crypto = require('crypto');

function generateSign(params, key) {
    // Get sorted parameter keys (exclude sign)
    const sortedKeys = Object.keys(params)
        .filter(k => k !== 'sign')
        .sort();
    
    // Concatenate parameter string
    const paramString = sortedKeys
        .map(k => `=`)
        .join('&');
    
    // Append time and key
    const signString = `&time=&key=`;
    
    // MD5 encrypt and convert to lowercase
    return crypto.createHash('md5')
        .update(signString, 'utf8')
        .digest('hex')
        .toLowerCase();
}

// Usage example
const params = {
    energyMode: '2',
    aiMode: '0',
    customTimes: '00:00,12:00,1000&13:00,15:00,-2000',
    batRatedCapacity: '1',
    batRatedChargingPower: '1000',
    dataTime: '2025-06-26',
    priceCompany: 'Germany',
    time: '1732756652'
};
const sign = generateSign(params, '2a1891544dbcf8e8b45b36d03187485a');
console.log('Generated signature:', sign);

using System;
using System.Collections.Generic;
using System.Linq;
using System.Security.Cryptography;
using System.Text;

public class SignGenerator
{
    public static string GenerateSign(Dictionary parameters, string key)
    {
        // Exclude sign field, sort by key
        var sortedParams = parameters
            .Where(p => p.Key != "sign")
            .OrderBy(p => p.Key, StringComparer.Ordinal)
            .Select(p => $"{p.Key}={p.Value}");
        
        // Concatenate parameters
        string paramString = string.Join("&", sortedParams);
        
        // Append time and key
        string signString = $"{paramString}&time={parameters["time"]}&key={key}";
        
        // MD5 encrypt and convert to lowercase
        using (var md5 = MD5.Create())
        {
            byte[] hashBytes = md5.ComputeHash(Encoding.UTF8.GetBytes(signString));
            StringBuilder sb = new StringBuilder();
            foreach (byte b in hashBytes)
            {
                sb.Append(b.ToString("x2")); // Convert to lowercase hex
            }
            return sb.ToString();
        }
    }
}

• • Header： 必须携带 companyCode: {企业识别码} 与 Accept-Language: en-US。
• • Body： 除业务参数外，必须包含 time（与签名生成时完全一致的 UTC+0 秒级时间戳）和 sign（MD5 签名值）。

curl --location 'https://api.aecc.com/openApi/price/setEnergyMode' \
--header 'companyCode: AECC2024001' \
--header 'Accept-Language: en-US' \
--header 'Content-Type: application/json' \
--data '{
    "energyMode": "2",
    "aiMode": "0",
    "customTimes": "00:00,12:00,1000&13:00,15:00,-2000",
    "batRatedCapacity": "1",
    "batRatedChargingPower": "1000",
    "dataTime": "2025-06-26",
    "priceCompany": "Germany",
    "time": "1732756652",
    "sign": "c3757db87150d5efbb45009d9253d375"
}'

import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;

public class ApiClient {
    private static final String API_URL = "https://api.aecc.com/openApi/price/setEnergyMode";
    private static final String COMPANY_CODE = "AECC2024001";
    private static final String KEY = "2a1891544dbcf8e8b45b36d03187485a";

    public static void main(String[] args) throws Exception {
        CloseableHttpClient httpClient = HttpClients.createDefault();
        HttpPost httpPost = new HttpPost(API_URL);
        
        // Set headers
        httpPost.setHeader("companyCode", COMPANY_CODE);
        httpPost.setHeader("Accept-Language", "en-US");
        httpPost.setHeader("Content-Type", "application/json");
        
        // Prepare business parameters
        long currentTime = System.currentTimeMillis() / 1000; // UTC+0 second timestamp
        TreeMap params = new TreeMap<>();
        params.put("energyMode", "2");
        params.put("aiMode", "0");
        params.put("customTimes", "00:00,12:00,1000&13:00,15:00,-2000");
        params.put("batRatedCapacity", "1");
        params.put("batRatedChargingPower", "1000");
        params.put("dataTime", "2025-06-26");
        params.put("priceCompany", "Germany");
        params.put("time", String.valueOf(currentTime));
        
        // Generate signature
        String sign = SignGenerator.generateSign(params, KEY);
        params.put("sign", sign);
        
        // Construct JSON request body
        JSONObject requestBody = new JSONObject();
        for (String key : params.keySet()) {
            requestBody.put(key, params.get(key));
        }
        httpPost.setEntity(new StringEntity(requestBody.toString(), "UTF-8"));
        
        // Send request
        String response = httpClient.execute(httpPost, response -> {
            int statusCode = response.getStatusLine().getStatusCode();
            String responseBody = EntityUtils.toString(response.getEntity());
            System.out.println("Status code: " + statusCode);
            return responseBody;
        });
        System.out.println("Response: " + response);
        httpClient.close();
    }
}

1. 身份校验：根据请求头中的 companyCode 查询对应的企业密钥
2. 时间戳校验：验证 time 参数是否在允许的时间范围内（默认±5 分钟），防止重放攻击
3. 签名重算：按相同规则（参数排序→追加 time 和 key→MD5 加密）重新计算签名
4. 签名对比：对比计算结果与请求中的 sign 值，完全一致方通过验证
5. 业务处理：验证通过后执行业务逻辑并返回结果

{
  "energyMode": "2",
  "aiMode": "0",
  "customTimes": "00:00,12:00,1000&13:00,15:00,-2000",
  "batRatedCapacity": "1",
  "batRatedChargingPower": "1000",
  "dataTime": "2025-06-26",
  "priceCompany": "Germany",
  "time": "1732756652",
  "sign": "c3757db87150d5efbb45009d9253d375"
}

• • packet： 十六进制控制报文，需按设备协议二次加密并计算 CRC16 校验后下发至采集器。
• • powerTimes： 时段策略数组，包含各时间段的充放电功率指令。

{
  "dataTime": "2024-09-07",
  "priceCompany": "Germany",
  "mode": "0",
  "time": "1725677116",
  "sign": "e07b26034722d166e7f059cb728ab3fd"
}

• • priceArr： 24小时电价数组，单位为 EUR/MWh。
• • pricesDayList： 时段明细列表，包含每个时间段的起止时间、电价数值及峰谷平标识。

{
  "deviceSn": "NB2548300T110CHAB",
  "time": "1725450897",
  "sign": "e83ba9c021edd831ae69033f77528ac5"
}

• • obj： 设备额定数据模型。

{
  "deviceSn": "NB2548300T110CHAB",
  "time": "1725450897",
  "sign": "e83ba9c021edd831ae69033f77528ac5"
}

• • obj： 设备实时数据模型。