mirror of
https://gitlab.com/vyla-entertainment/documentation.git
synced 2026-11-13 14:07:20 -05:00
rewrite
This commit is contained in:
@@ -6,15 +6,15 @@
|
||||
|
||||
`GET /health` (or `/api/health`) probes active providers and returns a JSON summary. It includes a status, timestamp, TMDB-key presence, cache size, and a map of provider keys to `{ ok, ms }` results.
|
||||
|
||||
Health is a signal, not a promise of playback. Provider behavior can differ by title, client network, and the moment of the request. Use it for observability and source selection—not as a guarantee that a viewer will receive a stream.
|
||||
Health is a signal, not a promise of playback. Provider behavior can differ by title, client network, and the moment of the request. Use it for observability and source selection-not as a guarantee that a viewer will receive a stream.
|
||||
|
||||
## Test one provider
|
||||
|
||||
`GET /test/:id?source=:providerKey` resolves a single provider for a movie. Add `season` and `episode` (or `s` and `e`) for TV.
|
||||
|
||||
```bash
|
||||
curl "http://localhost:7860/test/155?source=provider-key"
|
||||
curl "http://localhost:7860/test/1396?season=1&episode=1&source=provider-key"
|
||||
curl "YOUR_API_URL/test/155?source=provider-key"
|
||||
curl "YOUR_API_URL/test/1396?season=1&episode=1&source=provider-key"
|
||||
```
|
||||
|
||||
Use source keys reported by the running deployment. A test result reports whether resolution and verification succeeded; clients should inspect the result body rather than relying only on a transport success.
|
||||
|
||||
@@ -14,8 +14,8 @@ The API supports both the short paths below and `/api`-prefixed equivalents. A m
|
||||
`id` is a TMDB ID. For example:
|
||||
|
||||
```bash
|
||||
curl -N "http://localhost:7860/movie?id=155"
|
||||
curl -N "http://localhost:7860/tv?id=1396&season=1&episode=1"
|
||||
curl -N "YOUR_API_URL/movie?id=155"
|
||||
curl -N "YOUR_API_URL/tv?id=1396&season=1&episode=1"
|
||||
```
|
||||
|
||||
## Event contract
|
||||
@@ -44,7 +44,7 @@ One event for each candidate that passes the service's verification pipeline.
|
||||
"source": {
|
||||
"source": "provider-key",
|
||||
"label": "Provider name",
|
||||
"url": "http://localhost:7860/api?url=…"
|
||||
"url": "YOUR_API_URL/api?url=…"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user