验证票据(CAS2.0)
功能介绍
应用验证票据,并获取用户信息。
接口约束
无
URI
GET /api/v1/cas/serviceValidate
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
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 |
请求成功。 |
错误码
请参见错误码。