Authentication

Configure authentication for your API connections

Authentication

Most APIs require authentication to access their data. API Mapper supports several authentication methods.

No Authentication

For public APIs that don't require authentication:

  1. Select None as the authentication type
  2. That's it - no additional configuration needed

Examples: JSONPlaceholder, REST Countries, some weather APIs

API Key

Many APIs use API keys for authentication. The key can be sent as a header or query parameter.

Header Authentication

Authorization: ApiKey your-api-key-here

Configuration:

  1. Select API Key as authentication type
  2. Set Location to Header
  3. Enter the Header Name (e.g., X-API-Key, Authorization)
  4. Enter your API Key

Query Parameter

https://api.example.com/data?api_key=your-key-here

Configuration:

  1. Select API Key as authentication type
  2. Set Location to Query Parameter
  3. Enter the Parameter Name (e.g., api_key, key)
  4. Enter your API Key

Bearer Token

OAuth2 and JWT-based APIs typically use Bearer tokens:

Authorization: Bearer eyJhbGciOiJIUzI1NiIs...

Configuration:

  1. Select Bearer Token as authentication type
  2. Enter your Token

For APIs with expiring tokens, you may need to periodically update the token in your connection settings.

Basic Authentication

Some APIs use HTTP Basic Auth with username and password:

Authorization: Basic base64(username:password)

Configuration:

  1. Select Basic Auth as authentication type
  2. Enter your Username
  3. Enter your Password

API Mapper automatically encodes the credentials.

Security Best Practices

Keep Credentials Secure

API keys and tokens are stored in your database. While they are not publicly visible, always:

  • Use keys with minimal required permissions
  • Rotate keys periodically
  • Use read-only API access when possible

Troubleshooting Authentication

"401 Unauthorized" error

  • Double-check your credentials
  • Verify the authentication type matches what the API expects
  • Check if the API key has expired

"403 Forbidden" error

  • Your credentials may lack required permissions
  • Some APIs restrict access by IP address
  • Check API documentation for rate limits

Next Steps

Was this page helpful?

On this page