Authentication

Datazone provides secure authentication methods for accessing its APIs and services.

API Key Authentication

Obtaining an API Key

  1. Log into your Datazone account
  2. Navigate to Settings > API Keys
  3. Click “Generate New Key”
  4. Save the key securely - it won’t be shown again

Using API Keys

Include the API key in your requests:

curl -H "Authorization: Bearer YOUR_API_KEY" https://api.datazone.co/v1/datasets

API Key Best Practices

  • Keep keys secure and never expose them in client-side code
  • Rotate keys regularly
  • Use different keys for different environments
  • Limit key permissions to only what’s needed

Role-Based Access Control

Available Roles

  • admin: Full access to all resources
  • read_only: Read-only access to resources

Error Handling

Common Authentication Errors

Status CodeDescriptionSolution
401Invalid API keyVerify key is correct and active
403Insufficient permissionsCheck required roles
429Rate limit exceededImplement backoff strategy