Skip to main content

GET /api/mgmnt/v2/:namespace/:application/

Returns the OpenAPI 2.0 specificationOpens in a new tab for the given REST service. The REST service can be either a newer REST service or a manually-coded REST service.

URL Parameters

namespace Required. Namespace name. This parameter is not case-sensitive.
application Required. Fully qualified name of the package that contains the spec, impl, and disp classes. This parameter is not case-sensitive.

Permissions

To use this endpoint, you must have read access to the given namespace. If no namespace is specified, or if the specified namespace is %SYS, you must have read access to the default namespace (USER). Note that you can set the default namespace to a different namespace; to do so, set the global node ^%SYS("REST","UserNamespace") equal to the desired namespace.

You must also have read access to the database that contains the dispatch class. The dispatch class namespace and the endpoint namespace need to be the same (except in the case of a dispatch class in a package starting with %, which is available to all namespaces).

Example Request

  • Request Method:

    GET

  • Request URL:

    http://localhost:52773/api/mgmnt/v2/user/myapp

Response

This call returns a Swagger (OpenAPI 2.0Opens in a new tab) specification as documented at https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.mdOpens in a new tab. In the returned specification:

  • host is always set to the server:port of the server that you called.

  • basePath is set to the first web application that dispatches to this REST application. If no web application dispatches to this REST application, then basePath is returned as in the .spec class.

FeedbackOpens in a new tab