12/12/2024 11:37:56

服务端渠道开发规则

MSDK 服务器会根据请求，发送 HTTP(S) POST 请求到游戏插件服务器：

一、MSDK 服务器与插件服务器交互协议

• 接口协议：HTTP/HTTPS
• 请求方式：POST
• 请求 PATH：根据不同的渠道在 开放平台渠道创建 配置的地址
• 请求参数：每个请求的 Query Parameter 中都会携带 channelid， gameid， os 三个参数，请求体中的参数请参见具体接口，其中
  • channelid 为 MSDK 平台定义的第三方渠道的渠道 ID
  • gameid 为 MSDK 平台定义的游戏业务 ID
  • os 为 MSDK 平台定义的请求来源平台，1 - Android， 2 - iOS， 3 - Web，4 - Linux， 5 - Windows
• 参数校验规则：如游戏有校验请求参数的合法性需求，可以通过如下规则进行处理
  • 参数校验字段 sig，为 32 位 MD5 小写字符串
  • sig 填写规则：md5(PATH + "?" + QueryParameter + PostBody + SigKey)，其中 SigKey 即为飞鹰管理端中开放平台渠道配置的 app_key

示例：

POST /auth/login/?channelid=101&gameid=10&os=1&sig=4db5bdf075e280757ef4b0d93ad3aacb HTTP/1.1
Host: openplatformtest.com
Content-Type: application/json
Content-Length: 278

{
    "appid": "xxxxx",
    "channel_info": {
        "access_token": "EAAGBC9HZB9l4BAEWkk4T3b4d2gZCTrQVFmmtPZA6SoH4VCPO0XKkce47LUaOMMdzuo6q7JWM2RDLjyT1nehQWTTLcwyjyvKxy2AeNzPRTkI9dpBz78s5KOYf8omVMfMzrykdKcnQSYuRJ0zaCyaHJ1ZCeOg5HBnc8XnHwYk5EUp9htCFXw7RbTBVNU0rGxAkurqnnMLZC92N5gTbYF4NOUMZBd2iJDa7dmE6RNOb3gPAZDZD"
    }
}

二、sig 计算过程

以登录接口为例：

• PATH: /auth/login/ (管理端配置)
• QueryParameter: channelid=101&gameid=10&os=1
• PostBody: {"channel_info": {"access_token":"fbtoken"}}
• SigKey: xxxxx (管理端配置)

sig = md5(/auth/login/?channelid=101&gameid=10&os=1{"channel_info": {"access_token":"fbtoken"}}xxxxx) = 111019093c60a14e8ec57c21dbe7243c