Authentication

Getting Your API Key

1. Log in to your SEER dashboard
2. Navigate to Settings → API Keys
3. Click "Generate New API Key"
4. Give your key a descriptive name (e.g., "Production Pipeline")
5. Copy and securely store your API key

API Key Format

SEER API keys start with df_ followed by 64 hexadecimal characters:

df_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Using Your API Key

Include your API key in the auth header:

# HTTP Header
Authorization: df_your_api_key_here

# cURL Example
curl -H "Authorization: df_your_api_key_here" \
     https://api.seer.ansrstudio.com/monitoring

# Python Example
headers = {"Authorization": "df_your_api_key_here"}
requests.post(url, headers=headers, json=data)

Environment Variables

# .env file (never commit this!)
SEER_API_KEY=df_your_api_key_here

# Python
import os
api_key = os.environ['SEER_API_KEY']

# Node.js
const apiKey = process.env.SEER_API_KEY;

# Bash
export SEER_API_KEY="df_your_api_key_here"

Docker Secrets

# docker-compose.yml
services:
  pipeline:
    image: my-pipeline:latest
    environment:
      - SEER_API_KEY=${SEER_API_KEY}

# Or use Docker secrets
echo "df_your_api_key_here" | docker secret create seer_api_key -

AWS Secrets Manager

import boto3
import json

def get_api_key():
    client = boto3.client('secretsmanager')
    response = client.get_secret_value(SecretId='seer/api-key')
    secret = json.loads(response['SecretString'])
    return secret['api_key']

api_key = get_api_key()