客户端接入文档

$sign = hash_hmac('sha256', canonical($params), $appSecret);

<?php
$baseUrl = 'https://sq.yuanan6.cn';
$appKey = '你的 app_key';
$appSecret = '你的 app_secret';
$licenseKey = 'XL-XXXXX-XXXXX-XXXXX-XXXXX';

function canonical(array $params): string {
    unset($params['sign'], $params['sign_type']);
    $params = array_filter($params, function ($value) {
        return is_scalar($value) && $value !== '';
    });
    ksort($params, SORT_STRING);
    $pairs = [];
    foreach ($params as $key => $value) {
        $pairs[] = rawurlencode((string) $key) . '=' . rawurlencode((string) $value);
    }
    return implode('&', $pairs);
}

function apiRequest($baseUrl, $endpoint, $appKey, $appSecret, array $data) {
    $params = array_merge($data, [
        'app_key' => $appKey,
        'timestamp' => time(),
        'nonce' => bin2hex(random_bytes(16)),
    ]);
    $params['sign'] = hash_hmac('sha256', canonical($params), $appSecret);
    $ch = curl_init($baseUrl . '/api/v1/' . $endpoint);
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => http_build_query($params),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CONNECTTIMEOUT => 5,
        CURLOPT_TIMEOUT => 15,
    ]);
    $raw = curl_exec($ch);
    if ($raw === false) {
        throw new RuntimeException(curl_error($ch));
    }
    curl_close($ch);
    $response = json_decode($raw, true);
    if (!is_array($response) || !isset($response['sign'])) {
        throw new RuntimeException('响应格式或签名缺失');
    }
    $sign = $response['sign'];
    unset($response['sign']);
    $json = json_encode($response, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
    if (!hash_equals(hash_hmac('sha256', $json, $appSecret), $sign)) {
        throw new RuntimeException('响应验签失败');
    }
    return $response;
}

// 设备指纹应由客户端稳定生成，不要使用 IP 或随机值。
$deviceId = hash('sha256', '稳定的设备特征');
$result = apiRequest($baseUrl, 'activate', $appKey, $appSecret, [
    'license_key' => $licenseKey,
    'device_id' => $deviceId,
]);
if ($result['code'] !== 0) {
    exit($result['message']);
}
print_r($result['data']);