目录 [隐藏]
相信基本的OAuth协议 一步获得用户信息 获取用户GPS位置 获取用户人脸识别信息 OAuth链接的发布

OAuth协议（Authorization code授权认证）处理，主要流程分为三步：

现举例介绍网页Authorization code授权认证的具体实现步骤如下：

假设生活频道用户zyzx，有考勤网站： https://kq.hqit.com/ ， 网站绑定用户信息的页面为 https://kq.hqit.com/Bind 。 现要实现绑定相信用户，并获得网站相关信息功能，则需要执行如下步聚。

绑定页面网址是可以带参数的，我们建议您仅使用一个页面来接收并解析相信用户数据，解析成功之后再根据网址所带的参数进行页面跳转。例如绑定网址为 https://kq.hqit.com/Bind?to_fun=5，您的网站根据to_fun值跳至新的页面。
但需注意您绑定的网址不能使用：Code、Position、FaceInfo参数，以免与相信用户加密数据冲突。

第一步：请求code

1、用户在文本消息或菜单中设定OAuth链接
用户zyzx在编辑链接消息时不能直接使用 https://kq.hqit.com/Bind ，而是通过生活频道功能菜单下的OAuth网页授权，对其进行处理， 生成如下OAuth链接格式： https://civetinterface.foxconn.com/Open/oauth?appid=[您的AppID]&redirect_uri=https%3A%2F%2Fkq.hqit.com%2FBind&scope=snsapi_userinfo

注：1. appid是生活频道的身份标识，每个生活频道有一固定值。
    2. redirect_uri为重定向地址。
    3. scope为可选参数，值有：snsapi_userinfo(默认)、snsapi_base、snsapi_password。
        其中：
        ·snsapi_userinfo　返回的code能查询用户信息，但需要用户授权。用户授权一次在24小时内生活频道获取其用户信息。
        ·snsapi_base 仅能获得用户的openid，但无需用户授权。
        ·snsapi_password　返回的code能查询用户信息，但需要用户输入相信密码并授权。用户授权一次在30分钟内生活频道获取其用户信息。
    4. 可选参数scope_tips，值有：false、true（默认）。此参数仅在scope=snsapi_password有效，表示是否提示相信用户授权的资料范围，为true时提示。
    5. 可选参数timeout，值为数字。此参数在scope不等于snsapi_base时有效，表示用户授权一次的有效时间分钟数。
        ·scope=snsapi_userinfo时，默认值为1440（即一天）。设定时超过默认值1440则无效。
        ·scope=snsapi_password时，默认值为30。设定时超过默认值30则无效。
    6. 可选参数getlocation，值有：false（默认）、true。当为true可以获得用户位置信息。
    7. 可选参数getface，值有：false（默认）、true。当为true可以获得用户人脸识别信息。
                      

2、生活频道服务器接收请求後，将上述Url重置成：
https://kq.hqit.com/Bind?code=[加密Code]
其中code包含了订阅的信息及5分锺之後过期信息。

第二步：通过code获取openid、access_token

获取第一步的code后，请求以下链接获取openid、access_token
https://civetinterface.foxconn.com/open/access_token?code=[加密Code]&appid=[您的AppID]

接口返回信息 { "openid":"[OpenID]", "access_token":"[访问Token]", "expires_in":3600 }

其中openid是订阅者的身份标识，不同生活频道的订阅者有不同的openid。用户系统接口可以将openid绑到用户账号下次即可实现免登录。 expires_in为请求过期时间。

第三步：通过appid、openid、access_token获取订阅用户信息

接口地址为：
https://civetinterface.foxconn.com/open/get_user_info?appid=[您的AppID]&openid=[OpenID]&access_token=[访问Token]

得到用户信息 { "civetno": "F888888", "realname": "张飞", "sex": "男", "nickname": "张飞", "area": "龙华", "sign": "没有签名信息", "icon": "https://icivetmedia.foxconn.com/group1/M00/08/C2/CoaWx1cEn_2EEbajAAAAAKz3WPs002.png" }