Cloud Services

ModernOps configuration

APIs for RateCard/Clients_V2
Published On Oct 28, 2024 - 4:09 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