# 账号绑定功能接入

跳转中间页链接（微信游戏侧提供）示例：
https://game.weixin.qq.com/cgi-bin/h5/lite/externalaccount/authorization.html?appid=wg88fc141186626f15&biz_id=4

第三方平台登录绑定页链接（第三方提供）示例：https://test.m.v.qq.com/z/login-auth/wxGame/index.html?code=AAQeWlMFAAABAAAAAAB81kz5VUWpGwpf000GZxAAAADRmciqOyn39xY4x1PR3IA5CHkwxc0NRespfOhClr2s6ZDYmj0idPhoWf65H7z8WTo0OdhC-kpPsrMlXJusEO2x&open=1&callback_url=https%3A%2F%2Fgame.weixin.qq.com%2Fcgi-bin%2Fh5%2Flite%2Fexternalaccount%2Fauthorization.html%3Fgrant_biz_id%3D4%26grant%3D1%26appid%3Dwg88fc141186626f15%26biz_id%3D4

链接参数说明：
code: 微信游戏带在第三方平台的登录绑定页面链接上的微信游戏相关凭证；
open: 微信游戏带在第三方平台的登录绑定页面链接上的登录绑定成功的回调方式，即链接中 open=1 代表微信游戏告诉第三方成功后请使用 wx sdk 提供的关闭窗口的方法【见下方：第三方账号绑定页需具备的能力】关闭当前页面。
callback_url: 微信游戏带在第三方平台的登录绑定页面链接上的登录绑定成功的回调地址，注意如果已经有open=1这个参数和值请优先使用上述方法，否则重定向到callback_url。

微信游戏获取第三方应用的数据隐私授权链接（微信游戏提供）示例：
https://game.weixin.qq.com/cgi-bin/h5/lite/externalaccount/authorization.html?grant_biz_id=4&grant=1&appid=wgc0e34f8271dda8f0&biz_id=4&source=0

第三方平台（主体）获取微信游戏的数据隐私授权链接（微信游戏提供）示例：
https://game.weixin.qq.com/cgi-bin/h5/lite/externalaccount/authorization.html?grant_biz_id=4&grant=1&appid=wgc0e34f8271dda8f0&biz_id=4&source=1

如果某个第三方平台和微信游戏互相都需要获取对方数据，且隐私授权页都由微信游戏提供，则上述链接会带上 next=1, 表明还有下一步，例：
https://game.weixin.qq.com/cgi-bin/h5/lite/externalaccount/authorization.html?grant_biz_id=4&grant=1&appid=wgc0e34f8271dda8f0&biz_id=4&source=0&next=1

URL: https://game.weixin.qq.com/cgi-bin/gameplatformauthwap/getaccesstoken
POST:
{
	"game_platform_appid": "APPID", // 具体值是微信游戏给出的应用ID
    "code":"CODE" // 具体值登录页面上面微信游戏拼的 code 参数
}

返回：
{
	"game_platform_access_token": "ACCESS_TOKEN",
    "access_token_expire_time":1724811189,  
        // game_platform_access_token 过期时间，现在是两个小时
    "refresh_token_expire_time":1724811189, 
         // game_platform_refresh_token 过期时间，现在是一个月
    "game_platform_refresh_token": "REFRESH_TOKEN",
    "game_platform_openid":"OPENID"
}

URL:https://game.weixin.qq.com/cgi-bin/gameplatformauthwap/refreshaccesstoken
POST:
{
   "game_platform_appid": "APPID", // 具体值是微信游戏给出的应用ID
   "game_platform_refresh_token":"TOKEN", 
      // getaccesstoken 或者 refreshaccesstoken 接口返回的 game_platform_refresh_token，每次拿到新的都替换旧的
   "game_platform_openid":"OPENID" 
      // getaccesstoken 接口返回的 game_platform_openid，不会变
}

返回：
{
    "game_platform_access_token": "TOKEN",
    "access_token_expire_time":1724811189, 		   
        // game_platform_access_token 过期时间，现在是两个小时
    "game_platform_refresh_token":"REFRESH_TOKEN", 
    "refresh_token_expire_time":1724811189,		   
        // game_platform_refresh_token 过期时间，现在是一个月
    "game_platform_openid":"OPENID"
}

URL:https://game.weixin.qq.com/cgi-bin/gameplatformlogicwap/bindaccount?game_platform_access_token=TOKEN&game_platform_openid=OPENID
POST:
{
   "game_platform_appid": "APPID",
   "thirdplat_openid":"THIRDPLAT_OPENID", 
      // 第三方 openid，对于一个账号需要保证一个应用下唯一。由第三方生成=
   "thirdplat_nick_name":"NAME", // 用户在第三方的昵称，可选
   "masked_display_name":"DISPLAY_NAME", 
      // 用户在第三方的账号掩码，可选。比如手机号登录，可以传 "135******76"，方便用户在账号管理的时候提醒用户绑定了哪个账号
   "thirdplat_head_img_url":"URL" // 用户在第三方的头像，可选
}

返回：
{
	"errmsg": "ok"
}

URL:https://game.weixin.qq.com/cgi-bin/gameplatformlogicwap/unbindaccount?game_platform_access_token=TOKEN&game_platform_openid=OPENID
POST:
{
   "game_platform_appid": "APPID",
   "thirdplat_openid":"THIRDPLAT_OPENID"
}

返回：
{
	"errmsg": "ok"
}

URL:https://game.weixin.qq.com/cgi-bin/gameplatformlogicwap/getuserinfo?game_platform_access_token=TOKEN&game_platform_openid=OPENID
POST:
{
   "game_platform_appid": "APPID"
}

返回：
{
   "nick_name": "NAME",
   "head_img_url":"URL",
   "game_platform_openid":"OPENID"
}

URL:https://game.weixin.qq.com/cgi-bin/gameplatformlogicwap/reportgamedata?game_platform_access_token=TOKEN&game_platform_openid=OPENID
POST:
{
    "game_platform_appid": "APPID",          // 应用ID
	"thirdplat_appid": "wxd0ba2ae8ccfcda5e", 
        // 第三方游戏 appid，可以是开平的 appid，圈子的 group_out_id，由微信游戏给出
	"data_list": [{
		"key": "winbean", 
		"value": 1234 // // 如果是数值类型的就填数值，如果是字符串就填字符串
	}]
}

返回：
{
	"errmsg": "ok"
}

message GamePlatformUserData {
  optional string key = 4;                    // 数据的 key
  optional int64 value = 5;                   // 数值类型的 Value
  optional string string_value = 6;           // String value
  optional uint32 value_type = 7;             // value 的类型 1-数字 2-字符串
  optional uint64 last_update_time = 8;       // 最近更新时间
  optional int64 max_in_day = 9;              // 该天最大值 day_max
  optional uint64 max_stamp_in_day = 10;      // 该天最大值的上报时间 day_max_stamp
  optional int64 max_in_week = 11;            // 自然周最大值 week_max
  optional uint64 max_stamp_in_week = 12;     // 自然周最大值的上报时间 week_max_stamp
  optional int64 max_in_history = 13;         // 历史最大值 total_max
  optional uint64 max_stamp_in_history = 14;  // 历史最大值上报的时间 total_max_stamp
  optional int64 total_in_day = 15;           // 一天内的数值和
  optional int64 total_in_week = 16;          // 自然周的数值和
  optional int64 total_in_history = 17;       // 历史累加值
}

URL:https://game.weixin.qq.com/cgi-bin/gameplatformlogicwap/reportuserreflux
POST:
{
   "game_platform_appid": "APPID",
   "game_platform_refresh_token":"TOKEN",
   "game_platform_openid":"OPENID"
}

返回：
{
    "errmsg": "ok"
}