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:
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
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:
For this use case, it is also possible to use the
However, we recommend using the
authentication setting for credentials so that the Generic Extractor
configuration does not become a complete mess.
See example [EX077].
Usually you want the value used for authentication encrypted (the
api-token parameter with the value 2267709 in our example), so you are not exposing it to other users and also not storing it in the configuration versions history. The following authentication configuration combined with the parameter defined in the
config section does that (the value with the prefix
# is encrypted upon saving the configuration):
See example [EX094].