Getting Started with the Zenovay API

curl -O https://docs.zenovay.com/downloads/bruno-zenovay-collection.zip
unzip bruno-zenovay-collection.zip
# Abra a pasta bruno-zenovay-collection/ no app Bruno desktop.
# Escolha o ambiente "production", cole sua API key no arquivo local
# .env (gitignored — nunca commitado), e já pode chamar qualquer endpoint.

curl -X GET 'https://api.zenovay.com/api/external/v1/usage' \
-H 'X-API-Key: YOUR_API_KEY'

{
"success": true,
"data": {
  "api_key": {
    "id": "key_abc123",
    "name": "Custom Dashboard",
    "permission": "full_access",
    "website_id": null
  },
  "usage": {
    "monthly_requests": 42,
    "monthly_limit": 10000,
    "monthly_remaining": 9958,
    "monthly_reset_at": "2026-03-01T00:00:00.000Z",
    "total_requests": 1250
  },
  "rate_limits": {
    "requests_per_minute": 30
  },
  "subscription": {
    "tier": "pro"
  }
},
"timestamp": "2026-02-07T12:00:00.000Z"
}

{
"success": true,
"data": { ... },
"timestamp": "2026-02-07T12:00:00.000Z"
}

{
"success": false,
"error": {
  "code": "unauthorized",
  "message": "Invalid API key provided"
},
"timestamp": "2026-02-07T12:00:00.000Z"
}

curl -X GET 'https://api.zenovay.com/api/external/v1/websites' \
-H 'X-API-Key: YOUR_API_KEY'

{
"success": true,
"data": {
  "websites": [
    {
      "id": "ws_abc123",
      "domain": "example.com",
      "name": "Example Website",
      "tracking_code": "ZV_XXXXXXXXXXX",
      "is_active": true,
      "created_at": "2026-01-01T00:00:00Z",
      "team_id": "team_xyz"
    }
  ],
  "total": 1
},
"timestamp": "2026-02-07T12:00:00.000Z"
}

curl -X GET 'https://api.zenovay.com/api/external/v1/analytics/ws_abc123?range=7d' \
-H 'X-API-Key: YOUR_API_KEY'

{
"success": true,
"data": {
  "website": {
    "id": "ws_abc123",
    "domain": "example.com",
    "name": "Example Website"
  },
  "time_range": "7d",
  "date_range": {
    "start": "2026-01-31",
    "end": "2026-02-07"
  },
  "summary": {
    "total_visitors": 12543,
    "total_page_views": 45231,
    "unique_visitors": 8920
  },
  "daily_stats": [
    {
      "date": "2026-01-31",
      "total_visitors": 1823,
      "page_views": 6542,
      "unique_visitors": 1290
    }
  ]
},
"timestamp": "2026-02-07T12:00:00.000Z"
}

curl -H 'X-API-Key: YOUR_API_KEY' \
'https://api.zenovay.com/api/external/v1/websites'

async function fetchWithRetry(url, headers, maxRetries = 3) {
for (let attempt = 0; attempt < maxRetries; attempt++) {
  const response = await fetch(url, { headers });

  if (response.status === 429) {
    const retryAfter = parseInt(response.headers.get('Retry-After') || '60', 10);
    console.log(`Rate limited. Retrying in ${retryAfter}s...`);
    await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
    continue;
  }

  return response.json();
}

throw new Error('Max retries exceeded');
}

async function callZenovayAPI(endpoint) {
const response = await fetch(
  `https://api.zenovay.com/api/external/v1${endpoint}`,
  { headers: { 'X-API-Key': process.env.ZENOVAY_API_KEY } }
);

const result = await response.json();

if (!result.success) {
  const error = result.error;
  switch (response.status) {
    case 401:
      throw new Error('Invalid API key -- check your credentials');
    case 403:
      throw new Error(`Access denied: ${error.message}`);
    case 404:
      throw new Error(`Not found: ${error.message}`);
    case 429:
      throw new Error('Rate limited -- slow down requests');
    default:
      throw new Error(`API error: ${error.message}`);
  }
}

return result.data;
}