Files
cloudkitty/doc/source/api-reference/v2/rating/modules.inc
Quentin Anglade 9f9f4f1233 Add rating modules GET endpoints to v2 API
This introduces GET methods for rating modules in the v2 API. Work items:

* Implement the "/v1/rating/modules" endpoints in the v2 API, including
  unit tests and documentation

Story: 2006572
Task: 36677

Co-Authored-By: Rafael Weingärtner <rafael@apache.org>

Change-Id: I0a2f24051d268a396955c8df7e3e5615546f6293
2022-03-21 11:27:37 -03:00

77 lines
1.3 KiB
HTML

=======================
Rating modules endpoint
=======================
Get the list of modules
=======================
Returns the list of all rating modules loaded. This method does not require any
parameter.
.. rest_method:: GET /v2/rating/modules
Status codes
------------
.. rest_status_code:: success http_status.yml
- 200
.. rest_status_code:: error http_status.yml
- 400
- 401
- 403
Response
--------
.. rest_parameters:: rating/modules_parameters.yml
- modules: modules_list
Response Example
----------------
.. literalinclude:: ./api_samples/rating/modules_list_get.json
:language: javascript
Get one module
==============
Returns the details of one specific module. This method does not require any
parameter.
.. rest_method:: GET /v2/rating/modules/<module_id>
Status codes
------------
.. rest_status_code:: success http_status.yml
- 200
.. rest_status_code:: error http_status.yml
- 400
- 401
- 403
- 404
Response
--------
.. rest_parameters:: rating/modules_parameters.yml
- module_id: module_id
- description: description
- enabled: enabled
- hot_config: hot_config
- priority: priority
Response Example
----------------
.. literalinclude:: ./api_samples/rating/module_get.json
:language: javascript