Cloud Services

ModernOps

APIs for RateCard/Clients_V2
Published On May 30, 2024 - 1:04 PM

APIs for RateCard/Clients_V2

Learn what the RateCard/Clients_V2 APIs are and what they are used for.
The following are the RateCard/Clients_V2 APIs, including parameters, and what they are used for.
API:
GET/shared/ratecard/clients
Used for:
Getting list of clients
Parameters
Name
Description
offset
integer
(query)
The first record of the page. Default is set to 0.
Default value : 0
limit
integer
(query)
The number of records on the page. Default is set to 20.
Default value : 20
sort_order
string
(query)
Sort the records in ascending or descending order. The default order is asc. Allowed values: asc or desc.
Available values : asc, desc
Default value : asc
sort_by
string
(query)
Sorting the records can be applied on specific field. Default value is asc.
Available values : name, client_id, updated_at, updated_by, created_at, created_by
Default value : name
Following values are available in the drop-down menu: name, client_id, updated_at, updated_by, created_at, created_by.
Response content type: application/json
Responses
Code
Description
200
Success
Example Value |
Model
{ "limit": 20, "offset": 0, "reasons": [ { "id": "oidhwd", "messages": [ "Successfully retrieved the ratecards" ], "status": "OK", "statusCode": 100, "translateCode": "RC_2002_GET_ALL_RATECARD", "translateParameters": [ "string" ] } ], "results": [ { "applicable_for": [ { "id": "string", "label": "string", "sequence": 0, "values": [ { "id": "string", "label": "string" } ] } ], "base_url": "string", "certs": "string", "client_id": "string", "created_at": "2023-05-12T19:44:44.198Z", "created_by": "string", "description": "string", "name": "string", "updated_at": "2023-05-12T19:44:44.198Z", "updated_by": "string" } ], "size": 0, "sort_by": "name", "sort_order": "asc" }
400
Bad Request
Example Value
| Model
{ "message": "sample message", "translateCode": "SAMPLE TRANSLATE CODE", "translateParameters": [ "param1", "param2" ] }
404
Client not Found
Example Value
| Model
{ "message": "sample message", "translateCode": "SAMPLE TRANSLATE CODE", "translateParameters": [ "param1", "param2" ] }
500
Internal Server Error
Example Value
| Model
{ "message": "sample message", "translateCode": "SAMPLE TRANSLATE CODE", "translateParameters": [ "param1", "param2" ] }
API:
POST/shared/ratecard/clients
Used for:
Creating a new client
Parameters
Name
Description
payload
*
required
Object
(body)
Example Value
| Model
{ "applicable_for": [ { "id": "string", "label": "string", "sequence": 0, "values": [ { "id": "string", "label": "string" } ] } ], "base_url": "string", "certs": "string", "client_id": "string", "created_at": "2023-05-12T20:04:37.586Z", "created_by": "string", "description": "string", "name": "string", "updated_at": "2023-05-12T20:04:37.586Z", "updated_by": "string" }
Parameter content type:
application/json
Response content type: application/json
Responses
201
Success
Example Value
| Model
{ "applicable_for": [ { "id": "string", "label": "string", "sequence": 0, "values": [ { "id": "string", "label": "string" } ] } ], "base_url": "string", "certs": "string", "client_id": "string", "created_at": "2023-05-12T20:04:47.836Z", "created_by": "string", "description": "string", "name": "string", "updated_at": "2023-05-12T20:04:47.836Z", "updated_by": "string" }
400
Bad Request
Example Value
| Model
{ "message": "sample message", "translateCode": "SAMPLE TRANSLATE CODE", "translateParameters": [ "param1", "param2" ] }
409
Conflict: Client already exists
Example Value
| Model
{ "message": "sample message", "translateCode": "SAMPLE TRANSLATE CODE", "translateParameters": [ "param1", "param2" ] }
500
Internal Server Error
Example Value
| Model
{ "message": "sample message", "translateCode": "SAMPLE TRANSLATE CODE", "translateParameters": [ "param1", "param2" ] }
API:
DELETE/shared/ratecard/clients/{client_id}
Used for:
Deleting a specified client
Parameters
Name
Description
client_id
*
required
string
(
path
)
client_id: enter the client id in the field
Response content type: application/json
Responses
Code
Description
200
Success
Example Value
| Model
{ "reasons": [ { "id": "oidhwd", "messages": [ "Successfully retrieved the ratecards" ], "status": "OK", "statusCode": 100, "translateCode": "RC_2002_GET_ALL_RATECARD", "translateParameters": [ "string" ] } ] }
400
Bad Request
Example Value
| Model
{ "message": "sample message", "translateCode": "SAMPLE TRANSLATE CODE", "translateParameters": [ "param1", "param2" ] }
404
Not Found
Example Value
| Model
{ "reasons": [ { "id": "oidhwd", "messages": [ "Successfully retrieved the ratecards" ], "status": "OK", "statusCode": 100, "translateCode": "RC_2002_GET_ALL_RATECARD", "translateParameters": [ "string" ] } ] }
API:
GET/shared/ratecard/clients/{client_id}
Used for:
Getting details for a specified client.
Parameters
Name
Description
client_id
*
required
string
(
path
)
client_id:
enter the client id in the field
Response content type: application/json
Responses
Code
Description
200
Success
Example Value
| Model
{ "reasons": [ { "id": "oidhwd", "messages": [ "Successfully retrieved the ratecards" ], "status": "OK", "statusCode": 100, "translateCode": "RC_2002_GET_ALL_RATECARD", "translateParameters": [ "string" ] } ], "result": { "applicable_for": [ { "id": "string", "label": "string", "sequence": 0, "values": [ { "id": "string", "label": "string" } ] } ], "base_url": "string", "certs": "string", "client_id": "string", "created_at": "2023-05-12T20:14:57.087Z", "created_by": "string", "description": "string", "name": "string", "updated_at": "2023-05-12T20:14:57.087Z", "updated_by": "string" } }
400
Bad Request
Example Value
| Model
{ "message": "sample message", "translateCode": "SAMPLE TRANSLATE CODE", "translateParameters": [ "param1", "param2" ] }
404
Client Not Found
Example Value
| Model
{ "message": "sample message", "translateCode": "SAMPLE TRANSLATE CODE", "translateParameters": [ "param1", "param2" ] }
API:
PATCH/shared/ratecard/clients/{client_id}
Used for:
Patching a specified client.
Parameters
Name
Description
payload
*
required
object
(
body
)
Example Value
| Model
{ "array_filters": [ {} ], "data": {} }
Parameter content type:
application/json
action
string
(query)
What kind of update action are you performing
Available values : set, pull, push
Default value : set
client_id *
required
string
(path)
client_id: enter the client id
Response content type: application/json
Responses
Code
Description
200
Success
Example Value
| Model
{ "reasons": [ { "id": "oidhwd", "messages": [ "Successfully retrieved the ratecards" ], "status": "OK", "statusCode": 100, "translateCode": "RC_2002_GET_ALL_RATECARD", "translateParameters": [ "string" ] } ] }
400
Bad Request
Example Value
| Model
{ "message": "sample message", "translateCode": "SAMPLE TRANSLATE CODE", "translateParameters": [ "param1", "param2" ] }
404
Not Found
Example Value
| Model
{ "reasons": [ { "id": "oidhwd", "messages": [ "Successfully retrieved the ratecards" ], "status": "OK", "statusCode": 100, "translateCode": "RC_2002_GET_ALL_RATECARD", "translateParameters": [ "string" ] } ] }
API:
PUT/shared/ratecard/clients/{client_id}
Used for:
Updating provided client
Parameters
Name
Description
payload
*
required
object
(
body
)
{ "applicable_for": [ { "id": "string", "label": "string", "sequence": 0, "values": [ { "id": "string", "label": "string" } ] } ], "base_url": "string", "certs": "string", "client_id": "string", "created_at": "2023-05-12T20:23:28.188Z", "created_by": "string", "description": "string", "name": "string", "updated_at": "2023-05-12T20:23:28.188Z", "updated_by": "string" }
Parameter content type:
application/json
client_id *
required
string
(path)
client_id: enter the client id
Response content type: application/json
Responses
Code
Description
200
Success
Example Value
| Model
{ "reasons": [ { "id": "oidhwd", "messages": [ "Successfully retrieved the ratecards" ], "status": "OK", "statusCode": 100, "translateCode": "RC_2002_GET_ALL_RATECARD", "translateParameters": [ "string" ] } ] }
400
Bad Request
Example Value
| Model
{ "message": "sample message", "translateCode": "SAMPLE TRANSLATE CODE", "translateParameters": [ "param1", "param2" ] }
404
Not Found
Example Value
| Model
{ "reasons": [ { "id": "oidhwd", "messages": [ "Successfully retrieved the ratecards" ], "status": "OK", "statusCode": 100, "translateCode": "RC_2002_GET_ALL_RATECARD", "translateParameters": [ "string" ] } ] }
Do you have two minutes for a quick survey?
Take Survey