Skip to main content

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
I