Authentication

All Eazip API requests require authentication using an API key.

Getting an API Key

1. Sign in to your Eazip dashboard
2. Navigate to API Keys in the sidebar
3. Click Create API Key
4. Give your key a descriptive name
5. Copy the key immediately (it won’t be shown again)

Using Your API Key

Include your API key in the Authorization header of every request:

curl https://api.eazip.io/jobs \
  -H "Authorization: Bearer YOUR_API_KEY"

API Key Best Practices

Security Tips

• Never expose API keys in client-side code
• Use environment variables to store keys
• Rotate keys periodically
• Use separate keys for development and production

Environment Variables

Store your API key in an environment variable:

export EAZIP_API_KEY="your_api_key_here"

Then use it in your requests:

curl https://api.eazip.io/jobs \
  -H "Authorization: Bearer $EAZIP_API_KEY"

In Your Code

Node.js:

const response = await fetch('https://api.eazip.io/jobs', {
  headers: {
    'Authorization': `Bearer ${process.env.EAZIP_API_KEY}`,
    'Content-Type': 'application/json',
  },
});

Python:

import os
import requests

response = requests.get(
    'https://api.eazip.io/jobs',
    headers={'Authorization': f'Bearer {os.environ["EAZIP_API_KEY"]}'}
)

Managing API Keys

You can manage your API keys from the dashboard:

• View all active keys
• Revoke keys that are no longer needed
• Create new keys for different environments

Error Responses

If authentication fails, you’ll receive a 401 Unauthorized response:

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  }
}

Common causes:

• Missing Authorization header
• Invalid API key
• Revoked API key