EN
Español
English
Português
    User Management

    User search by item type

    Petition Details

    • Base URL: {host}/ASMSAPI/
    • Uri: /api/v9/user/{id}/search?itemType={itemType}&projectId={projectId}&criteria={criteria}
    • Type: GET
    • Required headings:

    • content-type: application/json
    • X-Authorization: Bearer {token}

    URL Description

    • {host}: It represents the domain of the environment in which the API is located.
    • ASMSAPI/: Fixed API prefix.
    • URI: Specific endpoint for the request.


    EXAMPLE URL:

    https://{host}/ASMSAPI/api/v9/user/{id}/search?itemType={itemType}&projectId={projectId}&criteria={criteria}
    


    Parameters

    Name Data type Obligatory Description
    Id Number Yes Value identifier (Group ID, Customer Group ID, Company ID, and so on) for searching for users based on item type (itemType)
    itemType Enumerator Yes Search Type - Ci = 21 - ClientGroup = 64 - Company = 38 - Group = 49 - License = 68
    projectId Number Yes Project ID
    Criteria Text No User Search Text

    Body of the petition

    N/A

    Examples of uri

    • api/v9/user/17/search?itemType=group&projectId=2&criteria=abdy
    • api/v9/user/17/search?itemType=group&projectId=2&criteria=
    • api/v9/user/17/search?itemType=group&projectId=2

    Answer

    {
    
          "content": [
    
            {
    
                        "email": "tri@pri.comx",             "id": 150,
    
                        "name": "Abdy Sanjur",             "userName": "ASANJUR"         }
    
          ],
    
          "totalItems": 1
    
    }
    

    Response parameters

    Name Data type Description
    totalItems Number Total number of objects found
    content List Item listing
    email Text User Email
    Id Number User ID
    Name Text Username
    userName Text User aliases

    Error messages

    Code HTTP status Error Message
    500 InternalServerError FailureSearchUsers
    400 BadRequest InvalidTypeForSearch