Testinium
  • Testinium Cloud
    • GET STARTED
      • What is Testinium?
      • Go to Testinium
    • How to run tests in Testinium?
    • Testinium Cloud Navigation
  • LOGIN
    • Login
      • Log in to Testinium
      • Reset Password
  • DASHBOARD
    • Dashboard
  • USER PROFILE
    • User Profile
      • Account Information
  • PROJECTS
    • Projects
      • Create New Project
      • Summary
      • Scenarios
      • Plans
      • Advanced
      • Properties
  • SCENARIOS
    • Scenarios
      • Create Scenario
      • Edit Scenarios
      • Delete Scenarios
      • Create New Group
      • Sync Scenarios
  • PLANS
    • Plans
      • Create Plan
      • Edit Plans
      • Delete Plans
      • Report
      • Run Plan
      • Quick Run Plan
  • REPORTS
    • Reports
      • Test Execution(Auto)
      • Scheduled Reports(Periodically Scheduled)
        • Create New Periodically Reports
        • Edit Periodically Report
        • Delete Periodically Report
        • Periodically Report History
      • Smart Prioritization Report
  • AUTOMATED TEST
    • Automated Test
      • Test Code Generator(Web)
      • Test Code Generator(Android Web)
      • Test Code Generator(IOS Web)
      • Test Code Generator(Android App)
      • Test Code Generator(IOS App)
      • Operation Report
  • PLUGINS
    • Plugins
      • Jenkins
      • Automated Test
      • Jira
      • Slack
      • TestRail
  • API's
    • Auth
      • Login
    • Account
      • Delete Customer API
      • Get All Roles
      • Get Customer ID by Company ID
      • Get Package Price by Package, Period, and Currency
      • Get User Details by Customer ID and User ID
      • Get Customer Information
      • Get Last Subscribed Product Packages of Customer
      • Update User
      • Get Billings by Customer ID
      • Get Address Types
      • Get Phone Types
      • Get Countries
      • Get Live Testing Parallel Limit
      • Update Live Testing Parallel Limit
      • Update Repository Information
      • Get Users of a Customer
      • Get All Products
    • Project
      • Get All Projects
      • Get All Projects By ProjectID
      • Get All Projects By Company ID
      • Get All Active Projects
      • Create Mobile Project
      • Create Service Project
      • Create WEB Project
      • Create Project From Template
      • Upload Mobile App
      • Delete Mobile App
      • Get Framework Summary
      • Enable Project
      • Disable Project
      • Get Jira Settings By ProjectID
      • Update Project For Jira Issue Settings
      • Get TestRail Settings By ProjectID
      • Update Project TestRail Settings
      • Get Xray Settings By ProjectID
      • Update Xray Settings By ProjectID
      • Get Xray Project Key Activation Information
      • Delete Project
      • Get Branch List By ProjectID
      • Get Plugins
    • Plan
      • Get All Test Plans
      • Get Plan By Plan ID
      • Get All Parent Plans
      • Get All Plans By Project ID
      • Get Active Test Plans
      • Run Test Plan
      • Force Run Test Plan
      • Quick Run Test Plan
      • Check Test Plan Running Status
      • Create Test Plan
      • Update Test Plan
      • Delete Test Plan
      • Get Band Width Types
      • Get Maximum Execution Times
      • Get Browsers
      • Get All Desktop Environments
      • Get All Mobile Environments
      • Get Total Plan Count by Filter
      • Get Files of a Test Plan
    • Reports
      • Get All Test Executions By Plan ID
      • Get Test Execution By ID
      • Download Execution Report by ID
      • Get Test Results of Execution by Scenario ID
      • Get Detailed Test Result
      • Filter Test Executions
      • Get Total Test Execution Runtime
      • Get Test Results Per Day
      • Graph Prioritization
      • Graph Prioritization Scenario
      • Get Plans By Scheduled Reports
      • Create Scheduled Report
      • Get All Scheduled Reports
      • Get Scheduled Report by ID
      • Update Scheduled Report
      • Get Scheduled Report History
      • Delete Scheduled Report
      • Get Public Report Link
      • Get Automated Apps for a Company
      • Get Remote Test Results Detailed
      • Get Test Result Detailed
    • Scenario
      • Get All Scenarios
      • Get All Group Scenarios
      • Get Scenario By ID
      • Get Test Scenarios By Filter
      • Get Scenarios by Execution ID
      • Get Last Failed Scenarios of a Test Plan
      • Create Scenario
      • Create Group Scenario
      • Update Scenario
      • Delete Scenario
      • Delete Multiple Scenarios
      • Get Total Scenario Count by Filter
      • Get File List (Source Tree)
      • Get BDD Steps
      • Read Test Method List
  • RELEASE NOTES
    • Release Notes
      • Testinium-Cloud 2.13.8 Release Notes
      • Testinium-Cloud 2.13.6 Release Notes
      • Testinium-Cloud 2.13.5 Release Notes
      • Testinium-Cloud 2.13.4 Release Notes
      • Testinium-Cloud 2.13.3 Release Notes
      • Testinium-Cloud 2.13.2 Release Notes
      • Testinium-Cloud 2.13.1 Release Notes
      • Testinium-Cloud 2.13.0 Release Notes
      • Testinium-Cloud 2.12.4 Release Notes
Powered by GitBook
On this page
  • Endpoint Information
  • Request Parameters
  • Response
  • Error Codes
  • Example Request
  1. API's
  2. Auth

Login

The endpoint enables users to authenticate and acquire an access token. The access token is necessary to make authorized requests to secured endpoints in the system.


Endpoint Information

  • URL: https://account.testinium.com/uaa/oauth/token

  • Method: POST

  • Header: Basic Authentication (<username> and <password>)

  • Content-Type: application/x-www-form-urlencoded


Request Parameters

To obtain an access token, the following form-data parameters are required:

Parameter
Type
Required
Description

grant_type

String

Yes

The grant type, typically password.

username

String

Yes

The user's username.

password

String

Yes

The user's account password.

scope

String

No

The scope of access for the token, e.g., api.


Response

Upon a successful request, the server returns a response containing the access token and additional token information. This token is required for subsequent API calls.

{
  "access_token": "your-access-token",
  "token_type": "bearer",
  "refresh_token": "your-refresh-token",
  "expires_in": 3600,
  "scope": "openid",
  "jti": "unique-token-identifier"
}

Response Fields

Field
Type
Description

access_token

String

Token for authenticating API requests.

token_type

String

Type of token, usually bearer.

refresh_token

String

Token to refresh the access token upon expiration.

expires_in

Number

Time in seconds until the access token expires.

scope

String

The scope of the token's granted access.

jti

String

Unique identifier for the token.


Error Codes

The following error codes may be encountered during token generation:

HTTP Code
Error Message
Description

400

INVALID_REQUEST

The request is invalid or missing parameters.

401

INVALID_CLIENT

The <username> or <password> is incorrect.

403

ACCESS_DENIED

Authentication failed due to incorrect credentials.

500

INTERNAL_SERVER_ERROR

An unexpected error occurred on the server.


Example Request

Below is an example of a curl command to obtain an access token:

curl --location 'https://account.testinium.com/uaa/oauth/token' \
--header 'Authorization: Basic dGVzdGluaXVtU3VpdGVUcnVzdGVkQ2xpZW50OnRlc3Rpbml1bVN1aXRlU2VjcmV0S2V5' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=password' \
--data-urlencode 'username= <username>' \
--data-urlencode 'password= <password>'
PreviousAuthNextAccount

Last updated 3 months ago