Platform API平台接口

Round report URL单局报表地址

A one-time URL to a page showing one finished round: result, bets, wins and its wallet transactions.已结束的一局的一次性报表地址：结果、注单、派彩与该局的钱包交易。

POST/merchant/v1/rounds/report-url

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

A one-time URL to a page showing one round: the result, the player's bets and wins, and the round's wallet transactions. Request a fresh URL every time someone wants to look.

一局的一次性报表地址：页面显示这一局的结果、玩家每个点位的投注与赢、以及这一局的钱包交易。每次要看都重新申请。

Request body请求正文

roundIdstringrequired必填

The roundId we sent in /debit and /credit. Only your own rounds, and only rounds that are closed (paid out or refunded).平台在 /debit、/credit 里给的 roundId。只能是本商户的、已经关局（已派彩或已退款）的局。

langstringoptional可选

Page language, same rules as games/launch, e.g. en, zh-Hans. Default en; an unknown value falls back to English.页面语言，规则同 games/launch，如 en、zh-Hans。默认 en，认不出的按英文。

timeZonestringoptional可选

Time zone for every time on the page, an IANA name such as Asia/Shanghai; the page header shows it. Default UTC; an unknown name is INVALID_PARAM.页面上所有时间按这个时区显示，IANA 时区名，如 Asia/Shanghai；页头会标明。默认 UTC，认不出的回 INVALID_PARAM。

Response `data`响应 `data`

reportUrlstring

Opens once. The first open shows the report; a refresh, a second click or a forwarded copy shows "link expired" (HTTP 410).只能打开一次。第一次打开显示报表；刷新、再点一次或转发给别人都显示「链接已失效」（HTTP 410）。

expiresAtstring

Expiry if never opened (10 minutes after issue).一直没打开时的失效时间（签发后 10 分钟）。

Limit限流At most 60 report URLs per merchant per minute. Above that we answer MAINTENANCE with message too many report links, retry later; wait a minute and retry. A round that is not yours, not closed or does not exist is ROUND_NOT_FOUND (we do not tell these apart).每个商户每分钟最多 60 个报表地址，超了回 MAINTENANCE，说明 too many report links, retry later，过一分钟再试。不是本商户的、还没关局的、不存在的局一律 ROUND_NOT_FOUND（不区分）。

Result codes结果码

OK INVALID_PARAM MERCHANT_DISABLED ROUND_NOT_FOUND MAINTENANCE

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签名认证.

R-01 Normal正常 A closed round of this merchant本商户已关局的一局 Expected期望 OK

roundId of a closed wallet round已关局的钱包局号

reportUrl opens once and shows the round in the requested language and time zone.reportUrl 能打开一次，按请求的语言与时区显示。

R-02 Rejection拒绝 Unknown round局号不存在 Expected期望 ROUND_NOT_FOUND

roundId R0000000000000roundId R0000000000000

The three cases are not distinguished.三种情况不区分。

R-03 Rejection拒绝 Missing roundId缺少 roundId Expected期望 INVALID_PARAM

{}{}

R-04 Rejection拒绝 Unrecognized time zone时区无法识别 Expected期望 INVALID_PARAM

timeZone "GMT+8"timeZone "GMT+8"

Use IANA names such as Asia/Shanghai.要用 IANA 名，如 Asia/Shanghai。

R-05 Boundary边界 Rate limit调用频率上限 Expected期望 OK ×60 → MAINTENANCE

60 calls, then one more within the same minute同一分钟内调用 60 次后再调用 1 次

message: too many report links, retry later.message：too many report links, retry later。

R-06 Normal正常 Report URL is single-use报表地址一次性有效 Expected期望 HTTP 200 → HTTP 410

Open the reportUrl from R-01 twice打开 R-01 返回的 reportUrl 两次

The second open is refused.第二次打开被拒。

R-07 Normal正常 A cancelled round of this merchant本商户已取消的一局 Expected期望 OK

roundId of a cancelled wallet round已取消的钱包局号

R-08 Rejection拒绝 A round not yet closed尚未关局的一局 Expected期望 ROUND_NOT_FOUND

roundId of a void / open wallet round作废或未关局的钱包局号

R-09 Rejection拒绝 Another merchant's round其他商户的局 Expected期望 ROUND_NOT_FOUND

roundId of another merchant's closed round其他商户已关局的局号

R-10 Boundary边界 roundId of 32 charactersroundId 长 32 个字符 Expected期望 ROUND_NOT_FOUND

Maximum length, unknown round长度上限，局号不存在

R-11 Boundary边界 roundId of 33 charactersroundId 长 33 个字符 Expected期望 INVALID_PARAM

One character over the limit超出上限 1 个字符

R-12 Normal正常 IANA time zoneIANA 时区 Expected期望 OK

timeZone "Asia/Shanghai"timeZone "Asia/Shanghai"

R-13 Boundary边界 Surrounding spaces are trimmed首尾空格被去除 Expected期望 OK

roundId padded with spacesroundId 首尾带空格

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

roundId sent as a numberroundId 以数字发送

# source merchant-sign.sh (API_HOST, MERCHANT_CODE, SECRET_KEY in the environment) merchant_curl POST /merchant/v1/rounds/report-url '{"roundId":"R6KDVAEWF5M6ZT9F","lang":"zh-Hans","timeZone":"Asia/Shanghai"}'

import json, urllib.request from merchant_sign import signed_headers body = '{"roundId":"R6KDVAEWF5M6ZT9F","lang":"zh-Hans","timeZone":"Asia/Shanghai"}'.encode() # send exactly the bytes you signed headers = signed_headers(MERCHANT_CODE, SECRET_KEY, "POST", "/merchant/v1/rounds/report-url", body) req = urllib.request.Request(f"https://{API_HOST}/merchant/v1/rounds/report-url", 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 = '{"roundId":"R6KDVAEWF5M6ZT9F","lang":"zh-Hans","timeZone":"Asia/Shanghai"}'; // send exactly the string you signed const res = await fetch(`https://${API_HOST}/merchant/v1/rounds/report-url`, { method: 'POST', headers: signedHeaders(MERCHANT_CODE, SECRET_KEY, 'POST', '/merchant/v1/rounds/report-url', body), body, }); const env = await res.json(); if (env.code !== 'OK') throw new Error(`${env.code}: ${env.message}`); console.log(env.data);

body := []byte(`{"roundId":"R6KDVAEWF5M6ZT9F","lang":"zh-Hans","timeZone":"Asia/Shanghai"}`) // send exactly the bytes you signed req, _ := http.NewRequest("POST", "https://"+apiHost+"/merchant/v1/rounds/report-url", 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 = "{\"roundId\":\"R6KDVAEWF5M6ZT9F\",\"lang\":\"zh-Hans\",\"timeZone\":\"Asia/Shanghai\"}".getBytes(StandardCharsets.UTF_8); // send exactly the bytes you signed HttpRequest.Builder rb = HttpRequest.newBuilder(URI.create("https://" + API_HOST + "/merchant/v1/rounds/report-url")) .POST(HttpRequest.BodyPublishers.ofByteArray(body)); MerchantSign.signedHeaders(MERCHANT_CODE, SECRET_KEY, "POST", "/merchant/v1/rounds/report-url", 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 = '{"roundId":"R6KDVAEWF5M6ZT9F","lang":"zh-Hans","timeZone":"Asia/Shanghai"}'; // send exactly the bytes you signed $ch = curl_init('https://' . API_HOST . '/merchant/v1/rounds/report-url'); curl_setopt_array($ch, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS => $body, CURLOPT_HTTPHEADER => MerchantSign::signedHeaders(MERCHANT_CODE, SECRET_KEY, 'POST', '/merchant/v1/rounds/report-url', $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 = '{"roundId":"R6KDVAEWF5M6ZT9F","lang":"zh-Hans","timeZone":"Asia/Shanghai"}' # send exactly the bytes you signed uri = URI("https://#{API_HOST}/merchant/v1/rounds/report-url") req = Net::HTTP::Post.new(uri, MerchantSign.signed_headers(MERCHANT_CODE, SECRET_KEY, 'POST', '/merchant/v1/rounds/report-url', 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']

Round report URL单局报表地址

Request body请求正文

Response data响应 data

Result codes结果码

Test cases测试用例

Response `data`响应 `data`