Platform API平台接口

List games游戏目录

The tables and lobby entries of one platform that are open to your account.某个平台对本商户开放的机台与大厅入口。

POST/merchant/v1/games/list

Called by the merchant商户调用 · signed需签名

The catalog of one platform for your account: real tables and lobby entries.

某个平台对该商户开放的目录：真实机台与大厅入口。

Request请求

platformstringrequired必填

pp or evo (pp tables cannot be launched yet, see games/launch)pp 或 evo（pp 的机台暂时还进不去，见 games/launch）

langstringoptional可选

Language of name fields, e.g. en, pt-BR, zh-Hans. Default en. A name without a translation falls back to English. A malformed value is ignored (treated as not sent).name 字段的语言，如 en、pt-BR、zh-Hans，默认 en。没有该语言翻译的名称退回英文。格式不对的值当没传，不报错。

Response `data`响应 `data`

games[]array

Tables. Array order is the recommended display order.机台。数组顺序就是推荐的展示顺序。

games[].tableCodestring

Our table code. Pass it to games/launch; it is also tableCode in wallet calls. Stable; never construct it yourself.平台机台编码。进游戏时传它，钱包请求里的 tableCode 也是它。不会变；不要自己拼。

games[].platformstring

Same as request.同请求。

games[].gameTypestring

Game family, e.g.玩法，如 baccarat roulette blackjack game_show

games[].namestring

Display name in the requested lang (English fallback).按请求 lang 的显示名（没有翻译用英文）。

games[].platformTableIdstring

The game platform's own table id, for reference only.游戏平台自己的桌号，仅供参考。

games[].categoryCodesstring[]

Lobby categories this table belongs to; may be empty.所属大厅分类，可为空数组。

games[].imagesobject

{square, portrait, landscape} image URLs. A URL may exist before its file is uploaded — keep a fallback image.{square, portrait, landscape} 三种图片地址。地址可能先于文件上线，请准备兜底图。

lobbies[]array

Lobby entries: the main lobby and every category that has tables.大厅入口：主大厅，以及每个有机台的分类。

lobbies[].lobbyCodestring

Pass to games/launch. Opaque — read it from this list.进游戏时传它。不透明，只从这个列表里取。

lobbies[].namestring

Name in the requested lang (English fallback).按请求 lang 的名称（没有翻译用英文）。

lobbies[].imagesobject

As above.同上。

Note注意Being in the catalog does not guarantee that a particular player can enter (currency configuration, player status and maintenance also apply). The games/launch result is authoritative. Refresh the catalog every 5–30 minutes.在目录里不代表某个玩家一定进得去（还取决于币种配置、玩家状态、是否维护），以 games/launch 的结果为准。建议每 5–30 分钟刷新一次目录。

Result codes结果码

OK MERCHANT_DISABLED INVALID_PARAM

In addition to the common codes listed in另可能返回通用结果码，见 Result codes结果码.

Test cases测试用例

Run each case against the staging environment before go-live. Signature, timestamp, request ID and IP cases apply to every endpoint and are listed under上线前请在测试环境逐条执行。签名、时间戳、请求编号与 IP 相关用例适用于所有接口，见 Authentication签名认证.

L-01 Normal正常 EVO catalogEVO 目录 Expected期望 OK

{"platform":"evo"}{"platform":"evo"}

games[] and lobbies[] present; lobbies[0] is evo_lobby; names in English.有 games[] 与 lobbies[]；lobbies[0] 是 evo_lobby；名称为英文。

L-02 Normal正常 Localized names本地化名称 Expected期望 OK

{"platform":"evo","lang":"zh-Hans"}{"platform":"evo","lang":"zh-Hans"}

Names translated where we have them, English otherwise.有译名的显示译名，没有的回英文。

L-03 Boundary边界 Unknown language is ignored不认识的语言被忽略 Expected期望 OK

{"platform":"evo","lang":"!!"}{"platform":"evo","lang":"!!"}

Same as L-01, no error.同 L-01，不报错。

L-04 Rejection拒绝 Unknown platform平台不存在 Expected期望 INVALID_PARAM

{"platform":"xx"}{"platform":"xx"}

message names the field: platform.message 指出字段 platform。

L-05 Rejection拒绝 Body is not a JSON object正文不是 JSON 对象 Expected期望 INVALID_PARAM

[] (signed)[]（已签名）

L-06 Rejection拒绝 Missing platform缺少 platform Expected期望 INVALID_PARAM

{}{}

L-07 Boundary边界 Platform code is case-sensitive平台代码区分大小写 Expected期望 INVALID_PARAM

{"platform":"EVO"}{"platform":"EVO"}

L-08 Normal正常 PP catalogPP 目录 Expected期望 OK

{"platform":"pp"}{"platform":"pp"}

L-09 Boundary边界 Unknown fields are ignored未定义字段被忽略 Expected期望 OK

{"platform":"evo","extra":1}{"platform":"evo","extra":1}

L-10 Rejection拒绝 Wrong field type字段类型错误 Expected期望 INVALID_PARAM

{"platform":1}{"platform":1}

import json, urllib.request from merchant_sign import signed_headers body = '{"platform":"evo","lang":"en"}'.encode() # send exactly the bytes you signed headers = signed_headers(MERCHANT_CODE, SECRET_KEY, "POST", "/merchant/v1/games/list", body) req = urllib.request.Request(f"https://{API_HOST}/merchant/v1/games/list", data=body, headers=headers, method="POST") with urllib.request.urlopen(req, timeout=10) as resp: env = json.load(resp) if env["code"] != "OK": raise RuntimeError(env["code"] + ": " + env["message"]) print(env.get("data"))

const { signedHeaders } = require('./merchant-sign'); const body = '{"platform":"evo","lang":"en"}'; // send exactly the string you signed const res = await fetch(`https://${API_HOST}/merchant/v1/games/list`, { method: 'POST', headers: signedHeaders(MERCHANT_CODE, SECRET_KEY, 'POST', '/merchant/v1/games/list', body), body, }); const env = await res.json(); if (env.code !== 'OK') throw new Error(`${env.code}: ${env.message}`); console.log(env.data);

body := []byte(`{"platform":"evo","lang":"en"}`) // send exactly the bytes you signed req, _ := http.NewRequest("POST", "https://"+apiHost+"/merchant/v1/games/list", bytes.NewReader(body)) merchantsign.SignRequest(req, merchantCode, secretKey, body, time.Now()) resp, err := http.DefaultClient.Do(req) if err != nil { return err // transport failure: result unknown, retry with a new X-Request-Id } defer resp.Body.Close() var env struct { Code string `json:"code"` Message string `json:"message"` Data json.RawMessage `json:"data"` } if err := json.NewDecoder(resp.Body).Decode(&env); err != nil { return err } if env.Code != "OK" { return fmt.Errorf("%s: %s", env.Code, env.Message) }

byte[] body = "{\"platform\":\"evo\",\"lang\":\"en\"}".getBytes(StandardCharsets.UTF_8); // send exactly the bytes you signed HttpRequest.Builder rb = HttpRequest.newBuilder(URI.create("https://" + API_HOST + "/merchant/v1/games/list")) .POST(HttpRequest.BodyPublishers.ofByteArray(body)); MerchantSign.signedHeaders(MERCHANT_CODE, SECRET_KEY, "POST", "/merchant/v1/games/list", body).forEach(rb::header); HttpResponse<String> resp = HttpClient.newHttpClient().send(rb.build(), HttpResponse.BodyHandlers.ofString()); System.out.println(resp.body()); // {"code":"OK","message":"OK","data":{...}}

require 'MerchantSign.php'; $body = '{"platform":"evo","lang":"en"}'; // send exactly the bytes you signed $ch = curl_init('https://' . API_HOST . '/merchant/v1/games/list'); curl_setopt_array($ch, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS => $body, CURLOPT_HTTPHEADER => MerchantSign::signedHeaders(MERCHANT_CODE, SECRET_KEY, 'POST', '/merchant/v1/games/list', $body), CURLOPT_RETURNTRANSFER => true, CURLOPT_TIMEOUT => 10, ]); $env = json_decode(curl_exec($ch), true); if (($env['code'] ?? '') !== 'OK') { throw new RuntimeException($env['code'] . ': ' . $env['message']); } print_r($env['data']);

require 'net/http' require 'json' require_relative 'merchant_sign' body = '{"platform":"evo","lang":"en"}' # send exactly the bytes you signed uri = URI("https://#{API_HOST}/merchant/v1/games/list") req = Net::HTTP::Post.new(uri, MerchantSign.signed_headers(MERCHANT_CODE, SECRET_KEY, 'POST', '/merchant/v1/games/list', body)) req.body = body res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == 'https') { |h| h.request(req) } env = JSON.parse(res.body) raise "#{env['code']}: #{env['message']}" unless env['code'] == 'OK' p env['data']

{ "code": "OK", "message": "OK", "data": { "games": [ { "tableCode": "evo_lightning_roulette_01", "platform": "evo", "gameType": "roulette", "name": "Lightning Roulette", "platformTableId": "LightningTable01", "categoryCodes": [ "roulette" ], "images": { "square": "https://cdn.example.com/gameicon/square/evo_lightning_roulette_01.jpg", "portrait": "https://cdn.example.com/gameicon/portrait/evo_lightning_roulette_01.jpg", "landscape": "https://cdn.example.com/gameicon/landscape/evo_lightning_roulette_01.jpg" } } ], "lobbies": [ { "lobbyCode": "evo_lobby", "name": "EVO Lobby", "images": { "square": "https://cdn.example.com/gameicon/square/evo_lobby.jpg", "portrait": "https://cdn.example.com/gameicon/portrait/evo_lobby.jpg", "landscape": "https://cdn.example.com/gameicon/landscape/evo_lobby.jpg" } }, { "lobbyCode": "evo_lobby_roulette", "name": "Roulette", "images": { "square": "https://cdn.example.com/gameicon/square/evo_lobby_roulette.jpg", "portrait": "https://cdn.example.com/gameicon/portrait/evo_lobby_roulette.jpg", "landscape": "https://cdn.example.com/gameicon/landscape/evo_lobby_roulette.jpg" } } ] } }

List games游戏目录

Request请求

Response data响应 data

Result codes结果码

Test cases测试用例

Response `data`响应 `data`