平台简介
新手指南
API协议
API文档
单点登录集成
JS SDK文档
小程序插件
公告
常见问题
TEST_DIR011
TEST_DIR11
分类序号是1
开放平台使用操作手册
帮助中心 / 开放平台帮助文档 / CAS验证接口规范
CAS验证接口规范
CAS验证接口规范说明

CAS验证接口规范

接口说明

该接口用于验证平台方调用单点登录接口时传入的ticket参数是否正确(是否由平台方提供并颁发),并将对应的ticket兑换为正确的登录用户信息。

注意:为防重放攻击,请保证每一个ticket在经过该接口验证完成后,都会失效。

请求地址

平台方自拟,需支持https协议访问

请求方式

POST

请求参数

参数名称参数类型参说说明
ticketstring单点登录请求凭证,由平台方调用单点登录接口时传入

返回参数

(json格式)

参数名称是否必须参数类型参数说明
codeint返回响应码,如果验证成功,请返回0,非 0均认为验证失败
messagemessage返回响应信息,平台方自拟
resultTicketDetail单点登录验证成功后兑换的用户登录信息

TicketDetail:

参数名称是否必须参数类型参数说明
contactstring登录用户联系方式,请返回有效的手机号或邮箱
namestring登录用户姓名,仅通过单点登录自动注册用户生效,传递后自动注册的用户的姓名会默认为传递值
idcardstring登录用户证件号,仅通过单点登录自动注册用户生效,传递后自动注册的用户的证件号会默认为传递值

返回数据示例:

{
    "result": {
        "contact": "176xxx11011",
        "name": "张三"
    },
    "code": 0,
    "message": "SUCCESS"
}