# Unix / macOS
export EOR_API_KEY="eor_live_sk_..."

# Windows (PowerShell)
$env:EOR_API_KEY = "eor_live_sk_..."

# .env file (never commit this)
EOR_API_KEY=eor_live_sk_...

# Python (requires 3.9+)
pip install eorouter

# TypeScript / Node.js (requires Node 18+)
npm install @eorouter/sdk

# Verify
python -c "import eorouter; print(eorouter.__version__)"  # 1.4.0

import os
from eorouter import EoRouterClient

client = EoRouterClient(api_key=os.environ["EOR_API_KEY"])

# AOI: Rome city centre
rome = {
    "type": "Polygon",
    "coordinates": [[[12.45, 41.87], [12.55, 41.87],
                       [12.55, 41.95], [12.45, 41.95],
                       [12.45, 41.87]]]
}

results = client.search(
    aoi=rome,
    date_from="2026-03-01",
    date_to="2026-03-21",
    max_cloud_cover=20,
    sensor_types=["optical", "sar"],
    routing="sar_fallback_if_cloud",
    limit=10,
)

print(f"Found {'{'}results.matched{'}'} scenes across {'{'}len(results.provider_stats){'}'} providers")
for scene in results:
    print(
        f"  {'{'}scene.provider:12{'}'} | {'{'}scene.collection_id:30{'}'} | "
        f"GSD {'{'}scene.gsd_m{'}'}m | cloud {'{'}scene.cloud_cover{'}'}% | "
        f"score {'{'}scene.score:.2f{'}'} | {'{'}scene.price_display{'}'}"
    )

top_scene = results[0]

# Estimate cost first (no charge)
estimate = client.orders.estimate(
    scene_ids=[top_scene.scene_id],
    aoi=rome,
)
print(f"Estimated cost: €{'{'}estimate.total_eur{'}'}")

# Place the order (amount pre-authorized)
order = client.orders.create(
    scene_ids=[top_scene.scene_id],
    processing={"format": "COG", "clip_to_aoi": True, "aoi": rome},
    delivery={"type": "s3", "destination_id": "dest_prod"},
    confirm=True,
)
print(f"Order {'{'}order.order_id{'}'} → status: {'{'}order.status{'}'}")

# Poll until delivered (or use webhooks)
order.wait(timeout_minutes=60)
manifest = order.manifest()
for item in manifest["items"]:
    print(f"  {'{'}item['filename']{'}'}  {'{'}item['size_mb']:.1f{'}'} MB  s3://{'{'}item['bucket']{'}'}/{'{'}item['key']{'}'}")

# Register a Planet API key
curl -X POST https://api.eorouter.io/v1/credentials \
  -H "Authorization: Bearer $EOR_API_KEY" \
  -d '{"provider": "planet", "type": "api_key", "value": "PLxxx...", "name": "Planet prod"}'

# Amazon S3
curl -X POST https://api.eorouter.io/v1/destinations \
  -H "Authorization: Bearer $EOR_API_KEY" \
  -d '{
    "name": "prod-s3", "type": "s3",
    "bucket": "my-eo-data", "region": "eu-west-1",
    "access_key_id": "AKIAxxx", "secret_access_key": "xxx",
    "path_template": "/{year}/{month}/{order_id}/{provider}/{filename}"
  }'

# Google Cloud Storage
curl -X POST https://api.eorouter.io/v1/destinations \
  -d '{"name":"gcs","type":"gcs","bucket":"my-bucket","service_account_json":"..."}'

# Azure Blob
curl -X POST https://api.eorouter.io/v1/destinations \
  -d '{"name":"azure","type":"azure_blob","container":"eo-deliveries","connection_string":"..."}'

curl -X POST https://api.eorouter.io/v1/webhooks \
  -H "Authorization: Bearer $EOR_API_KEY" \
  -d '{
    "url": "https://yourapp.io/webhooks/eorouter",
    "event_types": [
      "order.completed", "order.failed",
      "tasking.confirmed", "tasking.acquired",
      "subscription.scene_match"
    ]
  }'

# Verify signatures in Python:
import hmac, hashlib

def verify(payload_bytes, headers, secret):
    sig = headers.get("X-EoRouter-Signature", "")
    parts = dict(p.split("=", 1) for p in sig.split(","))
    signed = parts["t"].encode() + b"." + payload_bytes
    expected = hmac.new(secret.encode(), signed, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, parts.get("v1", ""))

// Claude Desktop — claude_desktop_config.json
{
  "mcpServers": {
    "eo-router": {
      "url":     "https://api.eo-router.com/mcp",
      "headers": { "Authorization": "Bearer eor_live_sk_..." }
    }
  }
}

// Cursor — .cursor/mcp.json
{
  "mcpServers": {
    "eo-router": {
      "url": "https://api.eo-router.com/mcp",
      "env": { "EOR_API_KEY": "eor_live_sk_..." }
    }
  }
}

{
  "type": "eo_procure",
  "id": "get_sar_image",
  "config": {
    "aoi":          "{{workflow.inputs.target_aoi}}",
    "sensor_types": ["sar"],
    "routing":      "highest_resolution",
    "providers":    ["iceye", "capella", "umbra"],
    "budget_cap":   5000,
    "auto_confirm": false
  }
}