| Saryu Shah | 990f41d | 2019-08-30 04:13:06 +0000 | [diff] [blame] | 1 | .. This work is licensed under a Creative Commons Attribution 4.0 International License. |
| 2 | .. http://creativecommons.org/licenses/by/4.0 |
| Pamela Dragosh | d5ff988 | 2020-05-11 15:18:01 -0400 | [diff] [blame] | 3 | |
| 4 | .. DO NOT CHANGE THIS LABEL FOR RELEASE NOTES - EVEN THOUGH IT GIVES A WARNING |
| 5 | .. _offeredapis: |
| Saryu Shah | 990f41d | 2019-08-30 04:13:06 +0000 | [diff] [blame] | 6 | |
| 7 | |
| Pamela Dragosh | 22ded7e | 2019-10-03 08:20:42 -0400 | [diff] [blame] | 8 | Policy Offered APIs |
| 9 | =================== |
| Saryu Shah | 990f41d | 2019-08-30 04:13:06 +0000 | [diff] [blame] | 10 | |
| 11 | The Policy Framework supports the public APIs listed in the links below: |
| 12 | |
| Pamela Dragosh | b4a8ef2 | 2020-04-21 15:30:35 -0400 | [diff] [blame] | 13 | .. toctree:: |
| 14 | :maxdepth: 1 |
| 15 | |
| 16 | api/api |
| 17 | pap/pap |
| 18 | xacml/decision-api |
| lapentafd | a43eb54 | 2023-03-27 13:46:04 +0100 | [diff] [blame] | 19 | clamp/acm/api-protocol/acm-rest-apis |
| Pamela Dragosh | b4a8ef2 | 2020-04-21 15:30:35 -0400 | [diff] [blame] | 20 | |
| Pamela Dragosh | 22ded7e | 2019-10-03 08:20:42 -0400 | [diff] [blame] | 21 | Postman Environment for API Testing |
| 22 | ----------------------------------- |
| 23 | |
| 24 | The following environment file from postman can be used for testing API's. All you need to do is fill in the IP and Port information for the installation that you have created. |
| 25 | |
| lapentafd | a43eb54 | 2023-03-27 13:46:04 +0100 | [diff] [blame] | 26 | :download:`Postman Environment <PolicyAPI.postman_environment.json>` |
| 27 | |
| 28 | .. note:: |
| lapentafd | fa9ddbf | 2023-04-06 11:22:37 +0100 | [diff] [blame] | 29 | If you are testing on a Docker Installation use *http* as **protocol**, *localhost* as **IP**, |
| lapentafd | a43eb54 | 2023-03-27 13:46:04 +0100 | [diff] [blame] | 30 | and the values set in the `export-ports.sh <https://raw.githubusercontent.com/onap/policy-docker/master/compose/export-ports.sh>`_ as **PORT**. |
| lapentafd | fa9ddbf | 2023-04-06 11:22:37 +0100 | [diff] [blame] | 31 | More information in: :ref:`Docker Installation <docker-label>` |
| Pamela Dragosh | 22ded7e | 2019-10-03 08:20:42 -0400 | [diff] [blame] | 32 | |
| 33 | Postman Collection for API Testing |
| 34 | ---------------------------------- |
| 35 | |
| Ram Krishna Verma | 68966c0 | 2020-07-21 16:19:45 -0400 | [diff] [blame] | 36 | Postman collection for `Policy Framework Lifecycle API <https://github.com/onap/policy-api/blob/master/postman/lifecycle-api-collection.json>`_ |
| Pamela Dragosh | 22ded7e | 2019-10-03 08:20:42 -0400 | [diff] [blame] | 37 | |
| Ram Krishna Verma | 68966c0 | 2020-07-21 16:19:45 -0400 | [diff] [blame] | 38 | Postman collection for `Policy Framework Administration API <https://github.com/onap/policy-pap/blob/master/postman/pap-api-collection.json>`_ |
| 39 | |
| 40 | Postman collection for `Policy Framework Decision API <https://github.com/onap/policy-xacml-pdp/blob/master/postman/decision-api-collection.json>`_ |
| puthuparambil.aditya | a6c09a2 | 2020-07-27 12:09:40 +0100 | [diff] [blame] | 41 | |
| lapentafd | a43eb54 | 2023-03-27 13:46:04 +0100 | [diff] [blame] | 42 | API Swagger |
| 43 | ----------- |
| puthuparambil.aditya | a6c09a2 | 2020-07-27 12:09:40 +0100 | [diff] [blame] | 44 | |
| 45 | The standard for API definition in the RESTful API world is the OpenAPI Specification (OAS). The OAS, which is based on |
| 46 | the original "Swagger Specification," is being widely used in API developments. |
| 47 | |
| lapentafd | a43eb54 | 2023-03-27 13:46:04 +0100 | [diff] [blame] | 48 | OAS 3.0 is used to describe the API contracts, and those documents are added as a source artifacts. |
| puthuparambil.aditya | a6c09a2 | 2020-07-27 12:09:40 +0100 | [diff] [blame] | 49 | |
| lapentafd | fa9ddbf | 2023-04-06 11:22:37 +0100 | [diff] [blame] | 50 | `Swagger Specification for Policy API <./api/local-swagger.html>`_ |
| puthuparambil.aditya | a6c09a2 | 2020-07-27 12:09:40 +0100 | [diff] [blame] | 51 | |
| lapentafd | fa9ddbf | 2023-04-06 11:22:37 +0100 | [diff] [blame] | 52 | `Swagger Specification for Policy PAP <./pap/local-swagger.html>`_ |
| puthuparambil.aditya | a6c09a2 | 2020-07-27 12:09:40 +0100 | [diff] [blame] | 53 | |
| lapentafd | fa9ddbf | 2023-04-06 11:22:37 +0100 | [diff] [blame] | 54 | `Swagger Specification for Policy XACML-PDP <./xacml/local-swagger.html>`_ |
| lapentafd | a43eb54 | 2023-03-27 13:46:04 +0100 | [diff] [blame] | 55 | |
| lapentafd | fb73899 | 2023-04-14 10:05:26 +0100 | [diff] [blame] | 56 | `Swagger Specification for Policy DROOLS-PDP <./drools/local-swagger.html>`_ |
| lapentafd | a43eb54 | 2023-03-27 13:46:04 +0100 | [diff] [blame] | 57 | |
| lapentafd | fb73899 | 2023-04-14 10:05:26 +0100 | [diff] [blame] | 58 | `Swagger Specification for Policy ACM-R <./clamp/acm/api-protocol/local-swagger.html>`_ |
| lapentafd | a43eb54 | 2023-03-27 13:46:04 +0100 | [diff] [blame] | 59 | |
| 60 | |
| lapentafd | fa9ddbf | 2023-04-06 11:22:37 +0100 | [diff] [blame] | 61 | The YAML document can be also downloaded and imported in an web editor such as `Editor Swagger <https://editor.swagger.io/>`_ |
| lapentafd | a43eb54 | 2023-03-27 13:46:04 +0100 | [diff] [blame] | 62 | |
| 63 | An "OpenApi first" approach is adopted, so starting from the Swagger document we auto-generate interfaces that are implemented in the API controllers. |
| 64 | |
| 65 | .. note:: |
| 66 | The Swagger document can still be extracted from the code in the API that uses *Spring-Doc* dependency at the endpoint "../v3/api-docs/" |
| 67 | For Example ACM-Runtime endpoint |
| lapentafd | fa9ddbf | 2023-04-06 11:22:37 +0100 | [diff] [blame] | 68 | |
| 69 | ``http://<IP>:<PORT>/onap/policy/clamp/acm/v3/api-docs`` |