Health Check
curl --request GET \
--url http://localhost:7860/api/health \
--header 'Authorization: Bearer <token>'import requests
url = "http://localhost:7860/api/health"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://localhost:7860/api/health', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "7860",
CURLOPT_URL => "http://localhost:7860/api/health",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://localhost:7860/api/health"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://localhost:7860/api/health")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:7860/api/health")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": "<string>",
"timestamp": "<string>",
"tmdb": true,
"cache": 123,
"probe_id": "<string>",
"sources": {
"ok": true,
"ms": {}
}
}Utilities
Health Check
Probe all configured providers in real time and get per-source latency and status.
GET
/
api
/
health
Health Check
curl --request GET \
--url http://localhost:7860/api/health \
--header 'Authorization: Bearer <token>'import requests
url = "http://localhost:7860/api/health"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://localhost:7860/api/health', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_PORT => "7860",
CURLOPT_URL => "http://localhost:7860/api/health",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://localhost:7860/api/health"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://localhost:7860/api/health")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://localhost:7860/api/health")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status": "<string>",
"timestamp": "<string>",
"tmdb": true,
"cache": 123,
"probe_id": "<string>",
"sources": {
"ok": true,
"ms": {}
}
}The health endpoint probes every active provider using a known-good TMDB ID and reports whether each one is up, along with the response time in milliseconds. No query parameters needed.
This endpoint accepts any valid API key (including
Health checks are not cached. Each call triggers a fresh live probe of all active providers — expect a response time of 2–10 seconds depending on provider count and speed.
public) or a session token from POST /api/auth.
Request
curl http://localhost:7860/api/health \
-H "Authorization: Bearer public_api_key"
const res = await fetch('http://localhost:7860/api/health', {
headers: {
Authorization: 'Bearer public_api_key'
}
});
const data = await res.json();
if (data.status !== 'ok') {
const down = Object.entries(data.sources)
.filter(([, v]) => !v.ok)
.map(([k]) => k);
console.warn('Degraded providers:', down);
}
import requests
data = requests.get(
'http://localhost:7860/api/health',
headers={
'Authorization': 'Bearer public_api_key'
}
).json()
print(data['status'])
for source, info in data['sources'].items():
status = '✓' if info['ok'] else '✗'
ms = info['ms'] or 'N/A'
print(f' {status} {source}: {ms}ms')
interface SourceHealth {
ok: boolean;
ms: number | null;
}
interface HealthResponse {
status: 'ok' | 'degraded';
timestamp: string;
tmdb: boolean;
cache: number;
probe_id: string;
sources: Record<string, SourceHealth>;
}
const data: HealthResponse = await fetch(
'http://localhost:7860/api/health',
{
headers: {
Authorization: 'Bearer public_api_key'
}
}
).then(r => r.json());
Response Fields
string
required
Overall health of the API.
"ok"— all providers returned a valid stream"degraded"— one or more providers failed; others still work
string
required
ISO 8601 timestamp of when the health check was run.
boolean
required
Whether a
TMDB_API_KEY is configured. false means the meta field will be null in movie and TV responses.number
required
Number of entries currently in the in-memory stream cache.
string
required
The TMDB ID used to probe all providers during this health check.
object
required
Responses
- 200 — All OK
- 207 — Degraded
All providers are live and returned valid streams.
{
"status": "ok",
"timestamp": "2025-06-01T12:00:00.000Z",
"tmdb": true,
"cache": 12,
"probe_id": "155",
"sources": {
"provider-a": { "ok": true, "ms": 1204 },
"provider-b": { "ok": true, "ms": 980 },
"provider-c": { "ok": true, "ms": 2100 }
}
}
One or more providers failed. HTTP status is
207 Multi-Status. Working sources are still usable.{
"status": "degraded",
"timestamp": "2025-06-01T12:00:00.000Z",
"tmdb": true,
"cache": 4,
"probe_id": "155",
"sources": {
"provider-a": { "ok": true, "ms": 1204 },
"provider-b": { "ok": false, "ms": 435 },
"provider-c": { "ok": false, "ms": 1138 }
}
}
Status Reference
| HTTP | status field | Meaning |
|---|---|---|
200 | "ok" | All providers healthy |
207 | "degraded" | At least one provider down |
401 | — | Missing or invalid authentication |
A
207 Degraded response does not mean the API is unusable. Movie and TV endpoints will still return sources from whichever providers are working. Check data.sources.length > 0 rather than depending on status === "ok" when deciding whether to proceed.