更新时间:2024-08-30 GMT+08:00
分享

验证票据(CAS2.0)

功能介绍

应用验证票据,并获取用户信息。

接口约束

URI

GET /api/v1/cas/serviceValidate

表1 Query参数

参数

是否必选

参数类型

描述

service

String

应用接受票据的地址,必须与应用CAS配置中的应用回调URL一致。

ticket

String

票据,认证登录获取的Service Ticket。

format

String

响应用户信息的格式,可选择XML和JSON。

缺省值:XML

请求参数

响应参数

请求示例

查询CAS2.0接口验证票据,参数分别配置应用回调地址https://example.com及认证登录接口获取的认证票据ST-eYlKs8FrLCltwRwfm8AiwCxmQ8gAL...,使用JSON响应格式获取用户属性信息。

GET https://{domain_name}/api/v1/cas/serviceValidate?service=https://example.com&ticket=ST-eYlKs8FrLCltwRwfm8AiwCxmQ8gAL...&format=JSON

响应示例

状态码: 200

请求成功。

  • 示例 1
    <cas:serviceResponse xmlns:cas="http://www.yale.edu/tp/cas">
        <cas:authenticationFailure code="INVALID_TICKET">Ticket ST-l1HnvKIWa0hhKTapEMdR7CU31iSG2... not recognized</cas:authenticationFailure>
    </cas:serviceResponse>
    
  • 示例 2
    {
      "serviceResponse" : {
        "authenticationFailure" : {
          "code" : "INVALID_TICKET",
          "description" : "the ticket provided was not valid, ticket is ST-l1HnvKIWa0hhKTapEMdR7CU31iSG2..."
        }
      }
    }

状态码

状态码

描述

200

请求成功。

错误码

请参见错误码

相关文档