SSO登录用户同步到多说

接口说明

本接口用于完成用户首次使用社交账户登录多说,通过SSO实现站点注册后,将站点用户信息与多说用户信息建立关联。
SSO登录说明

URL

http://api.duoshuo.com/sites/join.`返回格式`

返回格式支持:json, jsonp

HTTP请求方式

POST

是否需要登录

请求参数

short_name string 必需

站点申请的多说二级域名。

secret string 必需

站点密钥。

access_token string 必需

SSO完成时从多说获得的用户token。请注意,access_token并不在user信息的数组里,而是和user并列的一个参数。

站点创建的用户信息。本接口是为让登陆完成后,使用社交账户登录多说并完成SSO后,站点新创建的用户,和多说系统中用户建立关联。支持的用户信息属性见下:

必需属性

user[user_key]

这个用户在用户站点中的ID(注意:此ID不是用户在多说的ID)

user[name]

用户的显示名

可选属性
user[role]

用户在原站点中的身份。支持参数值:administrator:管理员, editor:编辑, author:作者, user:用户。管理员将具有多说站点管理后台的所有控制权限,编辑将具有一定评论管理和数据查看权限。

user[avatar_url]

用户在站点中设定的头像地址

user[url]
用户设定的网址

user[email] 邮箱地址。用于被回复时的邮件提醒功能,以及评论管理时的显示等场合。

user[created_at]
用户创建时间。请注意时间的格式为yyyy-mm-dd hh:MM:ss。如2012/12/12 12:12:122012-1-12 12:12:12的格式,都不会被成功识别,第二个时间是因为月份应为01

返回数据示例

{
    "code":0,
    "response":
        {
            "user_id": 9999999,
    "name":"用户名",
    "url":"http://duoshuo.com",
    "avatar_url":"http://tp4.sinaimg.cn/2472294147/50/5620116219/1",
    "threads":100,
    "comments":3000
        }
    }
}

返回数据参数说明

code int 一定返回

结果码。0为成功。失败时为错误码。

errorMessage string

错误消息。当code不为0时,返回错误消息。

response array

多说api返回结果中,通常在response中含有主要返回数据。当code为0时返回。response是多说用户信息,当用户填写了email地址时,也将包含email地址信息

user_id int32 一定返回

用户在多说的对应id,正常返回后,表明站点所传递的在站点中id为user_key的用户,已经和多说id为user_id的用户建立了关联。