簽章規則

每次呼叫我方服務時都必須帶入 sign 參數。sign 由此次傳遞的參數加上 API Key 組合後產生。各 API 參數表中標示「參與簽章」的欄位，都要納入簽章計算；sign 本身不納入。

產生步驟

依 key 升序排序

將參數陣列依 key 值升序排序。

URL-encode 並組成 query string

將各參數轉換為 URL-encoded 後組成 query string。編碼結果須為大寫，例如 : 應轉換為 %3A，而非 %3a。

接上 API Key 並計算 MD5

在 query string 後方直接接上 API Key，計算 MD5 即為 sign。

範例

以取得遊戲列表為例，假設 API Key 為 a188va：

步驟	結果
參數	`lang=en-US`
接上 API Key	`lang=en-USa188va`
MD5 結果（`sign`）	`1e223cbbb0d30b1d3cc5e5764e1d88fa`

PHP 範例

sign.php

<?php
    $data = array(
     "start_time" => "2020-07-01T00:00:00.000+08:00",
     "end_time" => "2020-07-02T00:00:00.000+08:00",
     "page_size" => 2000,
     "page" => 1
    );

    // $data: 傳遞的參數陣列，若沒傳遞參數則放空陣列
    // $apiKey: 代理商的 API KEY
    function generateSign($data, $apiKey)
    {
       ksort($data);

       $httpQuery = http_build_query($data);
       // end_time=2020-07-02T00%3A00%3A00.000%2B08%3A00&page=1&page_size=2000&start_time=2020-07-01T00%3A00%3A00.000%2B08%3A00

       $sign = md5($httpQuery . "$apiKey");
       // 4dc6c36f26c18020fe871d000789c611

       return $sign;
    }
?>

開始使用

參考資料

產生步驟

範例

PHP 範例

​產生步驟

​範例

​PHP 範例

產生步驟

範例

PHP 範例