# B1认证（Login）
|   接口地址    |        /id/b1s/v1/Login        |
|---|---|
| 接口API功能描述 | 登录SAP                          |
| 调用方式      | Post                           |
| 接口备注      | 返回参数中的SessionId会使用在后续流程接口的请求头中 |
   
请求体参数
|   参数名称    | 参数描述  |  参数类型  |    参数说明    |
|---|---|---|---|
| CompanyDB | 账套数据库 | String | 登录的SAP账套库名 |
| UserName  | 用户名   | String | 登录使用的账号    |
| Password  | 用户密码  | String | 登录使用的账号密码  |
   
请求样例：
{
"CompanyDB": "SBODEMOCN ",
"UserName": "xxxxx",
"Password": "password"
}
返回参数
|      参数名称      |  上级参数   |     参数描述      |  参数类型  |             参数说明             |
|---|---|---|---|---|
| SessionId      |         | 会话标识          | String | 在后续流程接口的请求头中的cookie里使用，成功时返回 |
| Version        |         | SAP版本号        | String | 成功时返回                        |
| SessionTimeout |         | SessionId时间限制 | Int    | 默认30分钟，成功时返回                 |
| error          |         | 失败信息          | List   | 失败时返回                        |
| code           | error   | 错误代码          | Int    | SAP错误代码，失败时返回                |
| message        | error   | 错误信息          | List   | 失败时返回                        |
| value          | message | 错误详情          | String | SAP错误消息，失败时返回                |
   
返回样例：
（1）成功样例
{
"odata.metadata":"https://api-service.sperp.myhuaweicloud.com/6160/b1s/v1/$metadata#B1Sessions/@Element",
"SessionId": "ac79876e-1e72-11ed-8000-000c299130e0",
"Version": "1000190",
"SessionTimeout": 30
}
（2）失败样例
{
"error": {
"code": 100000027,
"message": {
"lang": "en-us",
"value": "Login failed"
}
}
}