https://app.uptimehunt.io/api/v1

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

X-Auth: your_prober_authentication_token_here

Authorization: Bearer <jwt_token>
Content-Type: application/json
Accept: application/json

{
  "name": "Production Website",
  "type": "http",
  "config": {
    "url": "https://example.com",
    "method": "GET"
  }
}

{
  "data": {
    "id": 1,
    "name": "Production Website",
    "type": "http",
    "status": "operational"
  },
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 100,
    "totalPages": 5
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Validation failed",
    "details": {
      "url": ["URL is required", "URL must be valid"],
      "interval": ["Value is below the minimum for your plan (300 s on Free)"]
    }
  },
  "timestamp": "2024-01-01T00:00:00Z",
  "path": "/api/v1/services",
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

GET /api/v1/services?page=2&limit=50

{
  "data": [],
  "meta": {
    "page": 2,
    "limit": 50,
    "total": 250,
    "totalPages": 5
  }
}

curl -X POST https://app.uptimehunt.io/api/v1/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "password": "your_password"
  }'

{
  "data": {
    "access": "eyJhbGciOiJIUzI1NiIs...",
    "refresh": "eyJhbGciOiJIUzI1NiIs...",
    "user": {
      "id": 1,
      "email": "user@example.com",
      "first_name": "John",
      "last_name": "Doe"
    }
  }
}

curl -X POST https://app.uptimehunt.io/api/v1/services \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production Website",
    "type": "http",
    "project_id": 1,
    "config": {
      "url": "https://example.com",
      "method": "GET",
      "expected_status_code": 200,
      "timeout": 30
    },
    "interval": 300
  }'

{
  "data": {
    "id": 1,
    "name": "Production Website",
    "type": "http",
    "status": "pending",
    "created_at": "2024-01-01T00:00:00Z",
    "config": {
      "url": "https://example.com",
      "method": "GET",
      "expected_status_code": 200,
      "timeout": 30
    }
  }
}

curl -X GET https://app.uptimehunt.io/api/v1/services/1/metrics/uptime \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

{
  "data": {
    "uptime_percentage": 99.95,
    "total_checks": 8640,
    "successful_checks": 8636,
    "failed_checks": 4,
    "period": "30d"
  }
}

try {
  const response = await fetch('/api/v1/services', {
    headers: { 'Authorization': `Bearer ${token}` }
  });

  if (!response.ok) {
    const error = await response.json();
    console.error('API Error:', error.error.message);
    // Handle specific error codes
    if (error.error.code === 'UNAUTHORIZED') {
      // Refresh token or redirect to login
    }
  }

  const data = await response.json();
  return data.data;
} catch (err) {
  console.error('Network error:', err);
}

async function refreshAccessToken(refreshToken) {
  const response = await fetch('/api/v1/auth/refresh', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ refresh: refreshToken })
  });

  const data = await response.json();
  return data.data.access;
}

# Request first page
GET /api/v1/services?page=1&limit=50

# Check meta.totalPages and fetch additional pages as needed
GET /api/v1/services?page=2&limit=50

{
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "An unexpected error occurred"
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

async function fetchWithRetry(url, options, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      const response = await fetch(url, options);
      if (response.status < 500) return response;

      // Wait before retry: 1s, 2s, 4s
      await new Promise(resolve =>
        setTimeout(resolve, Math.pow(2, i) * 1000)
      );
    } catch (err) {
      if (i === maxRetries - 1) throw err;
    }
  }
}

function validateService(service) {
  const errors = {};

  if (!service.name || service.name.length < 3) {
    errors.name = 'Name must be at least 3 characters';
  }

  if (!service.config?.url) {
    errors.url = 'URL is required';
  } else if (!isValidUrl(service.config.url)) {
    errors.url = 'URL must be valid';
  }

  return Object.keys(errors).length > 0 ? errors : null;
}

const cache = new Map();

async function getCachedServiceTypes() {
  if (cache.has('service-types')) {
    return cache.get('service-types');
  }

  const response = await fetch('/api/v1/service-types');
  const data = await response.json();

  cache.set('service-types', data.data);
  setTimeout(() => cache.delete('service-types'), 3600000); // 1 hour

  return data.data;
}

2024-01-01T00:00:00Z

{
  "created_at": "2024-01-01T00:00:00Z",
  "response_time": 250,
  "is_enabled": true
}

{
  "enabled": true,
  "is_public": false
}

Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS
Access-Control-Allow-Headers: Authorization, Content-Type, X-Auth
Access-Control-Max-Age: 86400