Introduction
The Orcanos REST API enables seamless integration with test automation frameworks and other automated processes, allowing for efficient data exchange and automation of key processes.
Getting Started
Create an API User
Navigate to Admin > Users & Groups > Users.
Click the ‘+’ button in the bottom-right corner to create a new user.
Set the First Name to “API” and the Last Name to “User”, ensuring the Username is “API.User” (see example below):
Assign Projects and Permissions
When creating the API User, you must choose which user groups and projects to assign the new user. Please ensure the API user is assigned to all relevant projects and has the appropriate permissions.
Please refer to our Users guide for more information on assigning users with groups and projects.
Generate an API Key
Navigate to Admin > System Configuration > API.
Check the checkbox next to Enable API Key to generate a unique key.
Authentication with the API Key
To authenticate API requests, include the API key in the request header:
Error Codes
What errors and status codes can a user expect?
- 500: An error has occurred or something was wrong
- 200: Data is OK, Success
- 401: Unauthorized, When Authorization token is not passed.
URL:
https://app.orcanos.com/ xxxxxx /api/v2/Json
https://app.orcanos.com/ xxxxxx /api/swagger/ui/index
Where xxxxxx is a customer account name. Users can enter their account name here.
JSON Response:
In Success:
“IsSuccess” : true ,
“Data” : Full Information of related API function will display here.
“Message” : “” ,
“HttpCode” : 200
In Failure:
“IsSuccess” : false ,
“Data” : Error Message will display here.
“Message” : “” ,
“HttpCode” : 500
REST APIs Library is here:
- QW_Login
- QW_Add_Defect
- QW_Update_Defect
- QW_Add_Object
- QW_Update_Object
- QW_Add_Object to Add Service Calls
- QW_Delete_Object
- QW_Get_Object
- QW_Get_Object_View
- Get_Execution_Run_Details_XML
- Record_Execution_Results_New
- QW_Get_Item_Add_Edit
- GetItemURL
- QW_Add_Step
- Qw_Add_MiscAttachment
- QW_Save_Customer
- QW_Get_CustomerList_FromName
- QW_Get_CustomerList
- Create_Tag_Web
- Delete_Tag_Web
- QW_Get_Object_Relations
- QW_Delete_Relation_Custom_Code
- QW_Add_Relations_Custom_Code
- QW_Delete_Relation
- QW_AddRelation
- QW_Get_Filter_Results
- Add_Test_Run_Param_Value
- Copy_Attachment_CopiedFrom_Item
- GetItemEnvironment
- QW_Get_Execution_Set
- QW_Get_RunParameter
- QW_Get_Section_Data
- QW_Delete_Attachment
- Generate_PDF_New
- QW_Get_Updated_Items_List
- QW_Get_Updated_Items_List_By_Date
- SystemTableValue_Get
- SysTableValue_Save
- SysTableValue_Delete
- Add Step
- Update Step
- Delete Step