Small change in developer-api docs

docs/Reference guides/developer-api.md

@@ -10,9 +10,9 @@ You can interact with the Biotz platform using the Developer API.
 
 ### API reference
 
-The API is documented in the [OpenAPI][] v3.0 format. You can browse the
-reference using [Biotz's Swagger][].
-
+The API endpoints are documented in the [OpenAPI][] v3.0 format. You
+can load and browse the [API specification][] from your tool of
+choice, or use our [Swagger UI][].
 
 ### Authentication
 
@@ -51,7 +51,8 @@ The id token has to be sent in every API request using the [HTTP Authorization r
 Authorization: Bearer <id-token>
 ```
 
+[API specification]: https://api.biotz.io/docs/specification/developer-api.yaml
+[Swagger UI]: https://api.biotz.io/docs/ui/index.html#/
 [OpenAuth Password Grant Flow]: https://www.oauth.com/oauth2-servers/access-tokens/password-grant/
 [OpenAPI]: https://swagger.io/resources/open-api/
-[Biotz's Swagger]: https://api.biotz.io/docs/ui/index.html#/
 [HTTP Authorization request header]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Authorization