EcoFlow API PHP class

<?php
/*
 * =====================================================
 * Author: Jiri Holakovsky
 * 
 * Description: This class is used to interact with the
 * EcoFlow API to retrieve device quota information.
 * It can return the data either as a PHP array or JSON
 * and includes the option to enable verbose mode for
 * debugging purposes.
 *
 * This class is provided for free. If you find it useful,
 * please consider giving a backlink from your website or
 * blog, or mention it in discussions.
 * 
 * https://www.elektrarna.solar/ecoflow-api-php-class.php
 * 
 * Thank you.
 *
 * Requirements:
 * - PHP 7.4 or higher
 * - cURL extension enabled
 * =====================================================
 */

class EcoFlowAPI {
    private $accessKey;
    private $secretKey;
    private $sn;
    private $returnArray;

    public function __construct($accessKey, $secretKey, $sn, $returnArray = 0) {
        $this->accessKey = $accessKey;
        $this->secretKey = $secretKey;
        $this->sn = $sn;
        $this->returnArray = $returnArray;
    }

    private function flattenData($data, $prefix = '') {
        $result = [];
        foreach ($data as $key => $value) {
            if (is_array($value)) {
                $result = array_merge($result, $this->flattenData($value, $prefix . $key . '.'));
            } else {
                $result[$prefix . $key] = $value;
            }
        }
        return $result;
    }

    private function generateSignature($nonce, $timestamp, $data) {
        $flattenedData = $this->flattenData($data);
        ksort($flattenedData, SORT_STRING);

        $signatureBase = http_build_query($flattenedData);
        $signatureBase .= sprintf('&accessKey=%s&nonce=%s&timestamp=%s', $this->accessKey, $nonce, $timestamp);

        $signatureBase = ltrim($signatureBase, '&');

        $signatureBytes = hash_hmac('sha256', $signatureBase, $this->secretKey, true);

        return bin2hex($signatureBytes);
    }

    public function getData() {
        $timestamp = round(microtime(true) * 1000);
        $nonce = uniqid();

        $params = [
            "sn" => $this->sn
        ];

        $signature = $this->generateSignature($nonce, $timestamp, $params);

        $apiUrl = "https://api-e.ecoflow.com/iot-open/sign/device/quota/all?" . http_build_query($params);

        $curl = curl_init();
        curl_setopt_array($curl, [
            CURLOPT_URL => $apiUrl,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER => [
                "accessKey: {$this->accessKey}",
                "sign: $signature",
                "timestamp: $timestamp",
                "nonce: $nonce"
            ],
            CURLOPT_VERBOSE => false
        ]);

        $response = curl_exec($curl);
        $httpCode = curl_getinfo($curl, CURLINFO_HTTP_CODE);
        $error = curl_error($curl);
        $errorNo = curl_errno($curl);

        curl_close($curl);

        if ($response === false || $httpCode !== 200) {
            return [
                "error" => "API request failed.",
                "httpCode" => $httpCode,
                "cUrlError" => $error,
                "cUrlErrorNo" => $errorNo,
                "response" => $response
            ];
        } else {
            $responseData = json_decode($response, true);
            if ($this->returnArray) {
                return $responseData;
            } else {
                return json_encode($responseData);
            }
        }
    }
}

// $api = new EcoFlowAPI("YOUR_ACCESS_KEY", "YOUR_SECRET_KEY", "YOUR_SERIAL_NUMBER", 1); // 1 for PHP array, 0 for JSON
// $result = $api->getData();
// print_r($result);
?>
Example PHP array (EcoFlow Delta Pro)
