API Overview

GopherHole provides both REST and JSON-RPC APIs.

Base URLs

All requests require authentication via API key:

Authorization: Bearer gph_your_api_key

For dashboard/session-based auth:

X-Session-ID: your_session_id

{
  "data": { ... }
}

{
  "error": "Error message"
}

{
  "jsonrpc": "2.0",
  "result": { ... },
  "id": 1
}

Or on error:

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32600,
    "message": "Invalid request"
  },
  "id": 1
}

Rate limit headers are included in responses:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1709100000