Authentication API
身份验证 Authentication API
API 概述
| API 类别 | API | 示例端点 | 描述 | 可见性 | 必传 |
|---|---|---|---|---|---|
| 认证 | 授权 | https://www.operator.com/oauth2.0/authorize | 为未认证用户提供登录和认证页面。如果用户直接访问 Empire Gaming 而未先登 录运营商，则会发生这种情况。 | 公开 | 否 |
| 认证 | 登出 | https://www.operator.com/logout | 当玩家选择登出（包括从 Empire Gaming 和运营商登出）时，这是用户将被重定向到的 URL。 | 公开 | 否 |
| 认证 | 验证授权码 | https://api.operator.com/oauth2.0/token | Empire Gaming 将使用运营商验证短期授权码。响应结果是访问令牌。 | IP 限制 | 是 |
| 认证 | 刷新令牌 | https://api.operator.com/oauth2.0/token | Empire Gaming 通过与运营商交换已过期的令牌以获取新令牌，来延长用户的 API 会话。 | IP 限制 | 否 |
| 认证 | 获取账户信息 | https://api.operator.com/account | 返回关于用户的账户信息。 | IP 限制 | 是 |
授权
https://www.operator.com/oauth2.0/authorize?response_type=code&client_id=VL001&redirect_uri=https://fl.empiregaming.io| 请求参数 | 类型 | 描述 |
|---|---|---|
| response_type | TEXT(40) | 应始终为 code |
| client_id | TEXT(40) | 运营商商户 ID |
| redirect_uri | TEXT(255) | 成功登录后重定向玩家的 URL。 |
1.
https://fl.empiregaming.io/2.
https://www.operator.com/oauth2.0/authorize?response_type=code&client_id=VL001&redirect_uri=https://fl.empiregaming.io3.
4.
5.
https://fl.empiregaming.io/?code=xyz123.登出
https://www.operator.com/logout1.
2.
3.
4.
5.
验证授权
请求示例
| 请求参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| grant_type | TEXT(40) | 是 | 应始终为 authorization_code |
| code | TEXT(255) | 是 | 授权码（客户端 API 中的 code URL 参数值） |
| client_id | TEXT(40) | 是 | 运营商商户 ID。 |
| client_secret | TEXT(255) | 是 | 运营商商户秘钥 |
成功响应
{
"access_token": "JewdX+n7R4DZekCEx6LxUtT87kU=",
"expires_in": 3600,
"refresh_token": "7uCIR6QZHUqYMT51OYVk2sliC3LV"
}| 响应参数 | 类型 | 必传 | 说明 |
|---|---|---|---|
| access_token | TEXT(255) | 是 | 访问令牌。Empire Gaming 将使用此令牌向运营商 API 请求此玩家的信息 |
| expires_in | INTEGER | 否 | 定义访问令牌到期的秒数。如果提供，Empire Gaming 将调用刷新令牌 API 以获取另一个令牌。默认为无到期。 |
| refresh_token | TEXT(255) | 否 | 用于在访问令牌过期时获取新访问令牌的令牌 |
错误响应
{
"errorCode": 1001,
"error": "Authorization code has expired"
}| 参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| errorCode | INTEGER | 是 | 如果 success 为 false，运营商需要提供错误代码 |
| error | TEXT(255) | 是 | 如果 success 为 false，运营商需要提供错误信息 |
刷新令牌
用于在当前令牌过期时检索新访问令牌。需要刷新令牌才能获取新访问令牌。
请求示例
| 请求参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| grant_type | TEXT(40) | 是 | 应始终为 refresh_token |
| refresh_token | TEXT(255) | 是 | 在验证授权码时返回的刷新令牌 |
| client_id | TEXT(40) | 是 | 运营商商户 ID |
| client_secret | TEXT(255) | 是 | 运营商商户秘钥 |
成功响应
{
"access_token": "HPoR5_e5FSXb8r_jL4dVAnxnHGNu",
"expires_in": 3600,
"refresh_token": "G9XRPkUgTGtR2JmSx0C22smppcU2"
}| 响应参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| access_token | TEXT(255) | 是 | 访问令牌。Empire Gaming 将使用此令牌向运 营商 API 请求此玩家的信息 |
| expires_in | INTEGER | 否 | 定义访问令牌到期的秒数。如果提供，Empire Gaming 将调用刷新令牌 API 以获取另一个令牌。默认为无到期。 |
| refresh_token | TEXT(255) | 否 | 用于在访问令牌过期时获取新访问令牌的令牌。默认为无法获取新访问令牌，这意味着访问令牌过期后，玩家将被重定向到运营商的登录页面以获取新授权码 |
错误响应
{
"errorCode": 1002,
"error": "Refresh token has expired"
}| 参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| errorCode | INTEGER | 是 | 如果 success 为 false，运营商需要提供错误代码 |
| error | TEXT(255) | 是 | 如果 success 为 false，运营商需要提供错误信息 |
获取玩家信息
请求示例
| 请求参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| client_id | TEXT(40) | 是 | 运营商商户 ID。 |
成功响应
| 真实玩家 | 试玩玩家 |
|---|---|
玩家类型参数 playerType 为 REAL (默认值) | 玩家类型参数 playerType 为 TEST |
{
"playerId": "a3u",
"sessionId": "HfuXQCzhIn",
"currency": "USD",
"balance": 405.64,
"language": "zh_CN",
"playerName": "highroller335",
"avatarUrl": "https://img.operator.com/avatar.png",
"homeUrl": "https://www.operator.com"
}{
"playerId": "ftp123",
"sessionId": "HfuXQCzhIn",
"currency": "CNY",
"balance": 1000.00,
"language": "zh_CN",
"playerName": "freetoplay123",
"playerType": "TEST"
}| 响应参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| playerId | TEXT(255) | 是 | 玩家账号 |
| sessionId | TEXT(255) | 是 | 会话 ID |
| currency | TEXT(3) | 是 免转钱包 否 转账钱包 | ISO 4217 货币代码。参见支持的语言和货币 |
| balance | DECIMAL(20, 4) | 是 免转钱包 否 转账钱包 | 玩家当前余额，以玩家的货币表示 |
| language | TEXT(255) | 是 | 玩家使用的语言 |
| playerName | TEXT(255) | 否 | 玩家名称 |
| avatarUrl | TEXT(255) | 否 | 玩家头像的链接 L。此链接是需要 HTTPS 协议支持 |
| homeUrl | TEXT(255) | 否 | 当玩家点击"首页"按钮时应用程序重定向的 URL |
| playerType | TEXT(4) | 否 | 玩家类型： REAL （默认值） TEST 用于免费试玩玩家 |
| partner | TEXT(255) | 请看描述栏 | 运营商下线 ID 是 对于使用多个 clientPartner 设置的单个 clientId 的客户，需要使用 clientPartner 参数。否 对于没有 clientPartner 设置的客户，则不需要使用该参数。 clientPartner 参数用于区分操作中不同部分的流量。在单一运营商设置中，通常不使用 clientPartner 参数，因此它不是必需的。然而，对于拥有多个业务分段和预定义 clientPartner 配置的运营商,包网网或聚合商等，clientPartner 参数是必须的。 |
错误响应
{
"errorCode": 1001,
"error": "Authorization token has expired"
}| 参数 | 类型 | 必传 | 描述 |
|---|---|---|---|
| errorCode | INTEGER | 是 | 如果 success 为 false，运营商需要提供错误代码 |
| error | TEXT(255) | 是 | 如果 success 为 false，运营商需要提供错误信息 |
Modified at 2025-10-09 06:56:50