Health

Server health

GET /health

Auth: Public (rate limited) Quick liveness check, use this for load balancer health probes or uptime monitoring.

Response

{
  "status": "ok",
  "timestamp": "2024-03-15T10:30:00.000Z",
  "service": "openinary-api"
}

Status codes: 200 healthy

Example

curl http://localhost:3000/health

Database health

GET /health/database

Auth: API Key required Detailed diagnostic, checks the SQLite database connection, file permissions, and table record counts.

Response

{
  "status": "ok",
  "timestamp": "2024-03-15T10:30:00.000Z",
  "database": {
    "connected": true,
    "path": "/app/data/openinary.db",
    "size": "2.4 MB",
    "permissions": "0644",
    "tables": {
      "user": 1,
      "session": 3,
      "account": 1,
      "verification": 0,
      "apiKey": 2
    }
  }
}

boolean

Whether the database connection is active.

string

Absolute path to the database file.

string

Database file size.

string

Octal file permissions.

object

Record counts per table. Useful for verifying migrations applied correctly.

string

Optional warning (e.g. unusual permissions).

string

Optional warning when the database file’s permissions are less restrictive than 600.

string

Optional error message if the database file’s permissions or size couldn’t be read.

string

Optional error message if table record counts couldn’t be retrieved.

Status codes: 200 healthy · 503 database connection failed

Example

curl http://localhost:3000/health/database \
  -H "Authorization: Bearer <api_key>"

Overview

Media

Files

Storage

Cache

Video Processing

API Keys

System

Server health

Response

Example

Database health

Response

Example

​Server health

​Response

​Example

​Database health

​Response

​Example

Server health

Response

Example

Database health

Response

Example