验证票据(CAS2.0) - ValidateServiceCAS20

功能介绍

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

接口约束

null

URI

GET /api/v1/cas/serviceValidate

表1 Query参数
参数	是否必选	参数类型	描述
service	是	String	应用接受票据的地址，必须与应用CAS配置中的应用回调URL一致。
ticket	是	String	票据，认证登录获取的Service Ticket。
format	否	String	响应用户信息的格式，可选择XML和JSON。

请求参数

无

响应参数

状态码：200

请求成功。

无

请求示例

查询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..."
    }
  }
}