【必看】接口说明书

<h2>接口说明书</h2> <h3>接口设计思路</h3> <pre><code>游戏服务器按照用户的状态设计系统，按状态确定该状态下能进行的操作； 用户状态分为四种：offline（离线），wander（闲逛），waitStart（等待开始），playing（游戏状态） 即接口路径即为http://xxx/offline/xxxx、http://xxx/wander/xxxx、http://xxx/waitStart/xxxx、http://xxx/playing/xxxx 除此之外，还提供通用接口，用户在任意状态都可以查询，路径http://xxx/common/xxxx</code></pre> <h3>一些约定</h3> <p><strong>请求权限</strong>：服务器有维护一个在线用户的状态表，在某一状态下才能正确请求该状态下提供的接口。部分接口能变更用户状态，以接口返回的结果为准。</p> <p><strong>帧</strong>：将每个玩家在自己轮次完成的操作、操作前的对局信息、操作后的对局信息、下一玩家的序号和手牌；四部分封装成帧</p> <p><strong>签证（token）</strong>：用户在一次登录后获取的一串字符串，用来标明用户身份；有效期为6小时，超时失效；可以重新登录或者请求更新同时获取新的token；大部分接口都需要发送token完成验证后才能操作；</p> <p><strong>几个时限：</strong> 1、用户在加入房间后成为Player，状态转变为waitStart，5分钟未开始游戏则自动退出登录！需重新登录才可继续游戏。</p>