GET /external/api/v3/user?name={name}
Get a single user by username.
Request Information
URI Parameters
Name | Description | Type | Additional information | Nullable |
---|---|---|---|---|
name | string |
Required |
False |
Body Parameters
None.
Response Information
Resource Description
UserModelName | Description | Type | Additional information | Nullable |
---|---|---|---|---|
Roles | Collection of RoleModel |
None |
False | |
Username | string |
Required |
False | |
Type |
Internal or external. |
string |
Required |
False |
HasSingleActiveRole | boolean |
None |
False |
Response Formats
application/json, text/json
Sample:
{ "Username": "sample string 1", "Roles": [ { "Name": "sample string 1", "Id": "32995c79-a52b-41ee-8dd8-6f2ad5f49d37" }, { "Name": "sample string 1", "Id": "32995c79-a52b-41ee-8dd8-6f2ad5f49d37" } ], "Type": "sample string 2", "HasSingleActiveRole": true }
application/xml, text/xml
Sample:
<UserModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Expoints.API.Extern.V1.Models"> <HasSingleActiveRole xmlns="http://schemas.datacontract.org/2004/07/Expoints.API.Extern.Models">true</HasSingleActiveRole> <Type xmlns="http://schemas.datacontract.org/2004/07/Expoints.API.Extern.Models">sample string 2</Type> <Username xmlns="http://schemas.datacontract.org/2004/07/Expoints.API.Extern.Models">sample string 1</Username> <Roles xmlns:d2p1="http://schemas.datacontract.org/2004/07/Expoints.API.Extern.Models"> <d2p1:RoleModel> <d2p1:Id>32995c79-a52b-41ee-8dd8-6f2ad5f49d37</d2p1:Id> <d2p1:Name>sample string 1</d2p1:Name> </d2p1:RoleModel> <d2p1:RoleModel> <d2p1:Id>32995c79-a52b-41ee-8dd8-6f2ad5f49d37</d2p1:Id> <d2p1:Name>sample string 1</d2p1:Name> </d2p1:RoleModel> </Roles> </UserModel>
Response Status Codes
Status Code | Name | Description |
---|---|---|
200 | OK | The request has succeeded. |
400 | Bad Request | Fulfilling the request would cause an invalid state. Request needs modification. |
401 | Unauthorized | Missing or invalid authentication token. |
403 | Forbidden | Server refuses to authorize the request. |
408 | Request Timeout | The server timed out waiting for the request. |
429 | Too Many Requests | Too many requests in a given amount of time. |
500 | Internal Server Error | The server encountered an unexpected condition which prevented it from fulfilling the request. |
503 | Service Unavailable | The server is unable to proces the request at the moment, try again later. |