Query Authentication

Query Authentication provides the simplest authentication method, in which the credentials are sent in the request URL. This is most often used with APIs which are authenticated using API tokens and signatures. Dynamic values of query parameters can be generated using user functions.

A sample Query authentication configuration looks like this:

{
    "api": {
        ...,
        "authentication": {
            "type": "query",
            "query": {
                "apikey": "2267709"
            }
        }
    }
}

Configuration Parameters

The following configuration parameters are supported for the query type of authentication:

  • query (required, object) — an object whose properties represent key-value pairs of the URL query

Basic Configuration Example

Let’s say you have an API which requires an api-token parameter (with value 2267709) to be sent with each request. The following authentication configuration does exactly that:

"authentication": {
    "type": "query",
    "query": {
        "api-token": "2267709"
    }
}

For this use case, it is also possible to use the defaultOptions setting. However, we recommend using the authentication setting for credentials so that the Generic Extractor configuration does not become a complete mess.

See example [EX077].