Addresses 9263 API request and some mod docs content types (quay#1396)

Co-authored-by: Steven Smith <[email protected]>

Author: stevsmit

api/master.adoc

@@ -45,8 +45,8 @@ include::modules/creating-v2-oauth-access-token.adoc[leveloffset=+2]
 
 //how to use the API
 include::modules/enabling-using-the-api.adoc[leveloffset=+1]
-include::modules/configuring-api-calls.adoc[leveloffset=+2]
 include::modules/using-the-api.adoc[leveloffset=+2]
+include::modules/configuring-api-calls.adoc[leveloffset=+2]
 include::modules/accessing-swagger-ui.adoc[leveloffset=+2]
 include::modules/automating-quay-using-the-api.adoc[leveloffset=+2]
 

modules/accessing-swagger-ui.adoc

@@ -1,11 +1,14 @@
-:_content-type: REFERENCE
+:_mod-docs-content-type: PROCEDURE
 [id="accessing-swagger-ui"]
 = Accessing {productname} Swagger UI
 
 {productname} administrators and users can interacting with the API by using the Swagger UI-an interactive web interface that compiles executable commands. The Swagger UI can be launched as a container that points to your {productname} instance's API discovery endpoint (`/api/v1/discovery`). After deploying the container, you can access the Swagger UI, which loads the OpenAPI specification for {productname} from the specified URL. {productname} administrators and users can explore the available endpoints and their structure.
 
 Use the following procedure to access the {productname} Swagger UI.
 
+.Prerequisites
+* You have set `BROWSER_API_CALLS_XHR_ONLY: false` in your `config.yaml` file.
+
 .Procedure
 
 . Enter the following command to deploy the Swagger UI container, pointing the URL to your {productname}'s API discovery endpoint. For example:

modules/adding-a-new-tag-to-image-api.adoc

@@ -1,4 +1,4 @@
-:_content-type: CONCEPT
+:_mod-docs-content-type: PROCEDURE
 [id="adding-tags-api"]
 = Adding a new tag to an image tag to an image by using the API
 
@@ -7,7 +7,6 @@ You can add a new tag, or restore an old one, to an image by using the API.
 .Prerequisites
 
 * You have link:https://access.redhat.com/documentation/en-us/red_hat_quay/{producty}/html-single/red_hat_quay_api_reference/index#creating-oauth-access-token[Created an OAuth access token].
-* You have set `BROWSER_API_CALLS_XHR_ONLY: false` in your `config.yaml` file.
 
 .Procedure
 

modules/adding-managing-labels-api.adoc

@@ -1,4 +1,4 @@
-:_content-type: CONCEPT
+:_mod-docs-content-type: PROCEDURE
 [id="adding-managing-labels-api"]
 = Adding and managing labels by using the API
 
@@ -7,7 +7,6 @@
 .Prerequisites
 
 * You have link:https://access.redhat.com/documentation/en-us/red_hat_quay/{producty}/html-single/red_hat_quay_api_reference/index#creating-oauth-access-token[Created an OAuth access token].
-* You have set `BROWSER_API_CALLS_XHR_ONLY: false` in your `config.yaml` file.
 
 .Procedure
 

modules/adjust-access-user-repo-api.adoc

@@ -4,7 +4,7 @@
 // * use_quay/master.adoc
 // * quay_io/master.adoc
 
-:_content-type: CONCEPT
+:_mod-docs-content-type: PROCEDURE
 [id="adjust-access-user-repo-api"]
 = Adjusting access settings for a repository by using the API
 
@@ -14,7 +14,6 @@ Use the following procedure to adjust access settings for a user or robot accoun
 
 * You have created a user account or robot account.
 * You have link:https://access.redhat.com/documentation/en-us/red_hat_quay/{producty}/html-single/red_hat_quay_api_reference/index#creating-oauth-access-token[Created an OAuth access token].
-* You have set `BROWSER_API_CALLS_XHR_ONLY: false` in your `config.yaml` file.
 
 .Procedure
 

modules/adjusting-repository-access-via-the-api.adoc

@@ -3,7 +3,7 @@
 
 // * use_quay/master.adoc
 
-:_content-type: CONCEPT
+:_mod-docs-content-type: PROCEDURE
 [id="adjusting-image-repository-visibility-the-api"]
 = Adjusting repository visibility by using the API
 
@@ -12,7 +12,6 @@ The visibility of your repository can be set to `private` or `public` by using t
 .Prerequisites 
 
 * You have link:https://access.redhat.com/documentation/en-us/red_hat_quay/{producty}/html-single/red_hat_quay_api_reference/index#creating-oauth-access-token[Created an OAuth access token].
-* You have set `BROWSER_API_CALLS_XHR_ONLY: false` in your `config.yaml` file.
 * You have created a repository. 
 
 .Procedure

modules/automating-quay-using-the-api.adoc

@@ -1,4 +1,4 @@
-:_content-type: REFERENCE
+:_mod-docs-content-type: PROCEDURE
 [id="automating-quay-using-the-api"]
 = Automating {productname} processes by using the API
 
@@ -9,7 +9,6 @@ The following example shows you how you might use a Python script and a cron job
 .Prerequisites
 
 * You have access to the {productname} API, which entails having already created an OAuth 2 access token.
-* You have set `BROWSER_API_CALLS_XHR_ONLY: false` in your `config.yaml` file.
 * You have installed the Python `requests` library using.
 * You have enabled cron jobs on your machine.
 * You have created several organization applications, including one that will not be deleted.

modules/configuring-api-calls.adoc

@@ -1,7 +1,8 @@
+:_mod-docs-content-type: PROCEDURE
 [id="configuring-api-calls"]
-= Configuring {productname} to accept API calls
+= Enabling browser-based API calls in {productname}
 
-Prior to using the {productname} API, you must disable `BROWSER_API_CALLS_XHR_ONLY` in your `config.yaml` file. This allows you to avoid such errors as `API calls must be invoked with an X-Requested-With header if called from a browser`.
+By default, {productname} accepts CURL requests from the command line. However, if you want to enable API access from a browser extension such as Postman, or a browser interface such as Swagger, you must disable `BROWSER_API_CALLS_XHR_ONLY` in your `config.yaml` file.
 
 .Procedure
 

modules/creating-a-team-api.adoc

@@ -2,7 +2,7 @@
 
 // * use_quay/master.adoc
 
-:_content-type: PROCEDURE
+:_mod-docs-content-type: PROCEDURE
 [id="creating-a-team-api"]
 = Creating a team by using the API
 
@@ -16,7 +16,6 @@ Use the following procedure to create a team for your organization repository.
 
 * You have created an organization. 
 * You have link:https://access.redhat.com/documentation/en-us/red_hat_quay/{producty}/html-single/red_hat_quay_api_reference/index#creating-oauth-access-token[Created an OAuth access token].
-* You have set `BROWSER_API_CALLS_XHR_ONLY: false` in your `config.yaml` file.
 
 .Procedure
 

modules/creating-an-image-repository-via-the-api.adoc

@@ -3,7 +3,7 @@
 
 // * use_quay/master.adoc
 
-:_content-type: CONCEPT
+:_mod-docs-content-type: PROCEDURE
 [id="creating-an-image-repository-via-the-api"]
 = Creating a repository by using the API
 
@@ -16,7 +16,6 @@ Use the following procedure to create an image repository using the {productname
 .Prerequisites 
 
 * You have link:https://access.redhat.com/documentation/en-us/red_hat_quay/{producty}/html-single/red_hat_quay_api_reference/index#creating-oauth-access-token[Created an OAuth access token].
-* You have set `BROWSER_API_CALLS_XHR_ONLY: false` in your `config.yaml` file.
 
 .Procedure