Request authorization

Some APIs require you to set headers or parameters in order to authorize API requests.

You can set this up on the Authorization tab and the necessary headers/ parameters will be calculated and sent when the request runs.

These authorization types are supported:

• Bearer token

• Basic authentication

• OAuth

• Header

• Parameter

• AWS signature V4

Most API documentation will have an "Authentication" section which explains what type you should use.

Set up bearer token authentication

• On the create request screen, click "Authorization".

• Use the Type dropdown to select "Bearer Token".

• Enter the bearer token in the Token input.

• When your request runs, Data Fetcher will send an Authorization header with a value of Bearer YOUR_BEARER_TOKEN

Set up basic authentication

• On the create request screen, click "Authorization".

• Use the Type dropdown to select "Basic".

• Enter the username in the Username input.

• Optionally, enter the password in the Password input.

• When your request runs, Data Fetcher will automatically send an Authorization header with a value of Basic username:password (base64 encoded).

Set up OAuth authentication

• Check out this guide for how to set up OAuth authentication.

Set up header authentication

• On the create request screen, click "Authorization".

• Use the Type dropdown to select "Header".

• Enter the header Name in the input.

• Enter the header Value in the input.

• When your request runs, Data Fetcher will add a header with the name and value you specified.

Set up parameter authentication

• On the create request screen, click "Authorization".

• Use the Type dropdown to select "Parameter".

• Enter the parameter Name in the input.

• Enter the parameter Value in the input.

• When your request runs, Data Fetcher will add a parameter to the URL with the name and value you specified.

Set up AWS Signature V4 authentication

• On the create request screen, click "Authorization".

• Use the Type dropdown to select "AWS Signature V4".

• Enter your AWS Access key in the input.

• Enter your AWS Secret key in the input.

• Optionally, enter the AWS Region. If you leave this blank, Data Fetcher will try to infer it from the URL.

• Optionally, enter the AWS Service. If you leave this blank, Data Fetcher will try to infer it from the URL.

• If you are using temporary security credentials, enter the AWS Session token.

• When your request runs, Data Fetcher will calculate and add the X-Amz-Content-Sha256, X-Amz-Date & Authorization headers to authenticate with AWS.