Publishing a REST API
Merely creating a swagger.yaml file does not,
by itself, create a network endpoint. To create an API endpoint, you must explicitly publish
any APIs that you create by listing each API in file published-apis.yaml,
located in Studio in the following directory:
Guidewire requires that you publish REST APIs explicitly in file
published-apis.yaml for the following reasons:
- It gives you total control over the network exposure of Guidewire PolicyCenter. The REST API framework does not publish an API merely because the API is part of the base PolicyCenter application.
- It ensures that if you extend the Guidewire base API Swagger files, you can publish the resulting APIs using your own namespace and versioning schema.
- It ensure that you do not accidentally publish an API. Thus, it ensures that test, or development, APIs do not accidentally leak into the network.
