接口文档 - 棋牌对战API

快速开始

1. 获取API密钥

购买方案后，您将获得专属的API密钥（API Key）和密钥ID（Secret）。

2. 配置IP白名单

为确保安全，需要将您的服务器IP地址添加到白名单。请联系客服提供以下信息：

服务器IP地址
API密钥ID
预计调用量

3. 发起API请求

使用您的API密钥进行身份验证，调用对战策略接口。

接口地址

POST https://api.example.com/v1/strategy/move

身份验证

所有API请求都需要在Header中包含以下认证信息：

X-API-Key: your_api_key
X-API-Secret: your_api_secret
Content-Type: application/json

请求参数

参数名	类型	必填	说明
`game_type`	string	是	游戏类型：poker（扑克）、mahjong（麻将）
`board_state`	object	是	当前牌局状态
`hand_cards`	array	是	手牌列表
`history`	array	否	历史出牌记录
`difficulty`	integer	否	策略难度：1-10，默认5

请求示例

{
  "game_type": "poker",
  "board_state": {
    "community_cards": ["AH", "KD", "QS"],
    "pot_size": 1000,
    "current_bet": 200
  },
  "hand_cards": ["AS", "AD"],
  "history": [
    {"player": "A", "action": "raise", "amount": 100},
    {"player": "B", "action": "call", "amount": 100}
  ],
  "difficulty": 7
}

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "action": "raise",
    "amount": 300,
    "confidence": 0.85,
    "reasoning": "当前持有对A，翻牌圈出现AK，建议加注获取主动权",
    "think_time": 1500
  }
}

响应参数

参数名	类型	说明
`action`	string	建议动作：fold（弃牌）、call（跟注）、raise（加注）、check（过牌）
`amount`	integer	建议筹码数量
`confidence`	float	策略置信度：0-1之间
`reasoning`	string	策略推理过程
`think_time`	integer	建议思考时间（毫秒）

错误码说明

错误码	说明	处理建议
`401`	认证失败	检查API密钥是否正确
`403`	IP未授权	联系客服添加IP白名单
`429`	请求频率超限	降低调用频率或升级方案
`500`	服务器错误	稍后重试或联系技术支持

调用限制

方案类型	QPS限制	日调用量
季度方案	10 次/秒	100,000 次/天
年度方案	20 次/秒	300,000 次/天

需要帮助？

如需申请试用、添加IP白名单或有任何技术问题，请点击右下角客服图标联系我们。

API接口文档

🎯 免费试用