• • companyCode： Enterprise unique identifier (used for request header identity)
• • key： API signature key (only used for local signature generation, never transmit in plaintext)

• • Keys should be stored in server-side config files or environment variables, never hardcoded in client code
• • Regularly review key usage (quarterly recommended); contact official immediately if anomalies found
• • Use different credentials for different environments (test/production)
• • Limit key access to core developers; change keys when personnel leave

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： Must include companyCode: {Enterprise Code} and Accept-Language: en-US.
• • Body： In addition to business parameters, must include time (exact UTC+0 timestamp used in signature) and sign (MD5 signature value).

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. Identity verification: Query corresponding enterprise key based on companyCode in request header
2. Timestamp verification: Verify if time parameter is within allowed time range (default ±5 minutes), prevent replay attacks
3. Signature recalculation: Recalculate signature using same rules (sort params → append time and key → MD5 encrypt)
4. Signature comparison: Compare calculated result with sign value in request, must match exactly
5. Business processing: After verification passes, execute business logic and return result

{
  "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： Hexadecimal control message. Requires secondary encryption and CRC16 checksum calculation per device protocol before sending to collector.
• • powerTimes： Time period strategy array, containing charging/discharging power commands for each time period.

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

• • priceArr： 24-hour electricity price array, unit is EUR/MWh.
• • pricesDayList： Time period detail list, containing start/end time, price value and peak/valley/flat identifier for each period.

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

• • obj： Device rated data model.

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

• • obj： Device real-time data model.