Include Additional Headers in the API Console

Note

The Swagger API Console is a JavaScript client that runs in the API Store and makes JavaScript calls from the Store to the API Gateway. In order to successfuly invoke an API by specifying an additional header via the API console, first you must specify the header that you want to add, under the CORS ( Cross Origin Resource Sharing ) configuration.

Open the <API-M_HOME>/repository/conf/deployment.toml file, and specify the additional headers ( userId , in this case)under the [apim.cors] section: Alternatively, you could choose to add this additional header only to a specific API ( Enabling Cors per API).

CORS configurations in deployment.toml

    [apim.cors]
    enable = true
    allow_origins = "*"
    allow_methods = ["GET","PUT","POST","DELETE","PATCH","OPTIONS"]
    allow_headers = ["authorization","Access-Control-Allow-Origin","Content-Type","SOAPAction","userId"]
    allow_credentials = false

Next, let's see how to add the header as a parameter to the API Console.

  1. Log in to the API Publisher and click the API that you want to invoke (e.g., PetStore ).
  2. Click on the API and navigate to the resources tab. Choose the required resource (e.g POST method) to expand it. Note the parameters section highlighted below.

  3. Add a header parameter with the name userId. Once added the the newly added parameter should be listed as follows.

  4. Once you are done, click Save .

  5. Log in to the API Store, subscribe to the API and generate an access token for the application you subscribed with. Once done Click on the API and then navigate to the API console via the Test button.

  6. Once you expand the modified resource, you would notice that the added header parameter is visible in the API console and expecting an input.

You have now successfully added a header parameter to the API Console.

Top