feat: add OpenAPI v3 link to docs

Updates docs to include OpenAPI v3 links.

Signed-off-by: Daniel Mangum <[email protected]>

Author: hasheddan

docs/reference/3-rest-api/1-overview.mdx

@@ -6,18 +6,29 @@ title: Golioth REST API
 import useDocusaurusContext from "@docusaurus/useDocusaurusContext";
 export const SwaggerUrl = () => {
   const swaggerUrl = process.env.SWAGGER_URL;
-  return <a href={swaggerUrl}>{swaggerUrl}</a>;
+  return <a href={swaggerUrl}>Swagger / OpenAPI v2</a>;
 };
 
-You can use Golioth API for access all services available on the platform, like device management, provisioning, data resources and others services to be build in the future.
+export const OpenAPIUrl = () => {
+  const openAPIUrl = process.env.OPENAPI_URL;
+  return <a href={openAPIUrl}>OpenAPI v3</a>;
+};
+
+You can use Golioth API for access all services available on the platform, like
+device management, provisioning, data resources and others services to be build
+in the future.
 
 #### API Usage
 
-Our API is documented using OpenAPI definitions. You can access the [API Reference Page](/reference/rest-api/openapi) to check all endpoints and methods that can be used. A important aspect is authentication, that can be check on the [Authentication Guide](/reference/rest-api/auth).
+Our API is documented using OpenAPI definitions. You can access the [API
+Reference Page](/reference/rest-api/openapi) to check all endpoints and methods
+that can be used. For more information on authentication check the
+[Authentication Guide](/reference/rest-api/auth).
 
-#### Importing OpenAPI/Swagger definitions
+#### Importing OpenAPI/Swagger Definitions
 
-You can test Golioth API using a Graphical User Interface (GUI) like Postman or Insomnia. Here are some links on how to import Open API definitions using those projects. For the Swagger file URL, you can use <SwaggerUrl/> url to import our API definitions.
+You can test the Golioth API using a Graphical User Interface (GUI) like Postman
+or Insomnia. Both <OpenAPIUrl/> and <SwaggerUrl/> definitions are available.
 
 - https://learning.postman.com/docs/integrations/available-integrations/working-with-openAPI/
 - https://support.insomnia.rest/article/172-importing-and-exporting-data