API reference endpoints are used to get more information about the Smart Completions API itself. As an OData-compliant API, the Smart Completions API provides the common reference endpoints, as follows.
Reference |
Endpoint |
Authentication |
|
---|---|---|---|
Service document |
https://<hostname>/<base url>/ |
Yes |
The service document describing the resource URL. |
Service description |
https://<hostname>/ |
No |
The product, product name, version, scope, base URI, licenses, and IdP details for the API. Information relevant to different client applications, for example an identity provider might require the service description to register your Smart API. |
Metadata |
https://<hostname>/ |
Yes |
The data model of an OData API. It describes the entities, properties, relationships, and other structural information about the data. |
Annotations |
https://<hostname>/<base url>/Annotations/$metadata |
Yes |
Additional characteristics or capabilities of a metadata element, such as a service, entity type, property, function, action, or parameter. |