
# 验证票据(CAS2.0) - ValidateServiceCAS20
#### 功能介绍
应用验证票据，并获取用户信息。
#### 接口约束
null
#### URI
GET /api/v1/cas/serviceValidate
表1Query参数 
| 参数      | 是否必选 | 参数类型   | 描述                               |
|:---|:---|:---|:---|
| 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..."
      }
    }
  }
  ```
#### 状态码
| 状态码 | 描述    |
|:---|:---|
| 200 | 请求成功。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-oneaccess/ErrorCode.html)。
