baigo SSO


系统通知

系统通知与同步登录通知的区别是:系统通知是由 SSO 服务器直接发起,而同步登录通知则通常是根据同步登录接口返回的结果,由访问者浏览器发起。

系统会在“通知接口 URL”上附加相关参数,以便接收通知的系统识别。

公共通知参数

公共通知参数是指向所有通知发起时都传递的参数。

参数名 类型 描述 备注
code string 加密参数 需要将该参数进行解密,解密时,要把 App Key 作为 key 参数,App Secret 作为 iv 参数。
sign string 签名 将通知参数中的加密参数解密,得到一个 JSON 对象,直接将此对象进行签名验证,验证签名时,要把 App Key 和 App Secret 连接作为盐。
app_id int 应用的 App ID 后台创建应用时生成。
app_key string 应用的 App Key 后台创建应用时生成。

通知测试

本接口用于测试通知接口是否正常。

HTTP 请求方式

POST

URL 附加参数

m=sso&c=notify&a=test

加密参数
参数名 类型 描述 备注
echostr string 输出字符串 直接将该字符串输出便可确认该应用的通知接口正常
timestamp int UNIX 时间戳

解密结果示例

{
    "echostr": "sdferi84hkdfufdsERTeugroe7treie",
    "timestamp": "1550198497"
}

用户注册

本接口用于通知各应用有新用户注册成功。

HTTP 请求方式

POST

URL 附加参数

m=sso&c=notify&a=reg

加密参数
参数名 类型 描述
user_id int 用户 ID
user_name string 用户名
user_mail string 邮箱
user_nick string 昵称
user_contact array 联系方式
user_extend array 扩展信息
timestamp int UNIX 时间戳

解密结果示例

{
    "user_id": "1", //用户 ID
    "user_name": "baigo", //用户名
    "user_mail": "baigo@baigo.net", //邮箱
    "user_nick": "nickname" //昵称
    "user_contact": {
        "tel": {
            "key": "电话",
            "value": "0574-88888888"
        },
        "addr": {
            "key": "地址",
            "value": "浙江省宁波市"
        }
    },
    "user_extend": {
        "test": {
            "key": "名称",
            "value": "值"
        }
    },
    "timestamp": "1550198497"
}

编辑用户资料

本接口用于通知各应用用户信息编辑成功。

HTTP 请求方式

POST

URL 附加参数

m=sso&c=notify&a=edit

加密参数
参数名 类型 描述
user_id true int | 用户 ID
user_name true string | 用户名
user_mail true string | 邮箱
user_nick true string | 昵称
user_contact true array | 联系方式
user_extend true array | 扩展信息
timestamp int UNIX 时间戳

解密结果示例

{
    "user_id": "1", //用户 ID
    "user_name": "baigo", //用户名
    "user_mail": "baigo@baigo.net", //邮箱
    "user_nick": "nickname" //昵称
    "user_contact": {
        "tel": {
            "key": "电话",
            "value": "0574-88888888"
        },
        "addr": {
            "key": "地址",
            "value": "浙江省宁波市"
        }
    },
    "user_extend": {
        "test": {
            "key": "名称",
            "value": "值"
        }
    },
    "timestamp": "1550198497"
}

修改个人信息

本接口用于通知各应用用户信息编辑成功。

HTTP 请求方式

POST

URL 附加参数

m=sso&c=notify&a=info

加密参数
参数名 类型 描述
user_id true int | 用户 ID
user_nick true string | 昵称
user_contact true array | 联系方式
user_extend true array | 扩展信息
timestamp int UNIX 时间戳

解密结果示例

{
    "user_id": "1", //用户 ID
    "user_nick": "nickname" //昵称
    "user_contact": {
        "tel": {
            "key": "电话",
            "value": "0574-88888888"
        },
        "addr": {
            "key": "地址",
            "value": "浙江省宁波市"
        }
    },
    "user_extend": {
        "test": {
            "key": "名称",
            "value": "值"
        }
    },
    "timestamp": "1550198497"
}

更换邮箱

本接口用于通知各应用用户信息编辑成功。

HTTP 请求方式

POST

URL 附加参数

m=sso&c=notify&a=mailbox

加密参数
参数名 类型 描述
user_id true int | 用户 ID
user_mail true string | 邮箱
timestamp int UNIX 时间戳

解密结果示例

{
    "user_id": "1", //用户 ID
    "user_mail": "baigo@baigo.net", //邮箱
    "timestamp": "1550198497"
}

删除用户

原接口 替代方案 版本
删除用户 不再提供 v4.0 起