系统通知与同步登录通知的区别是:系统通知是由 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 | 后台创建应用时生成。 |
本接口用于测试通知接口是否正常。
POST
m=sso&c=notify&a=test
参数名 | 类型 | 描述 | 备注 |
---|---|---|---|
echostr | string | 输出字符串 | 直接将该字符串输出便可确认该应用的通知接口正常 |
timestamp | int | UNIX 时间戳 |
解密结果示例
{
"echostr": "sdferi84hkdfufdsERTeugroe7treie",
"timestamp": "1550198497"
}
本接口用于通知各应用有新用户注册成功。
POST
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"
}
本接口用于通知各应用用户信息编辑成功。
POST
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"
}
本接口用于通知各应用用户信息编辑成功。
POST
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"
}
本接口用于通知各应用用户信息编辑成功。
POST
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"
}
原接口 | 替代方案 | 版本 |
---|---|---|
删除用户 | 不再提供 | 4.0 起不再提供 |