API Stremio¶

Les endpoints Stremio sont les points d'entrée principaux du addon, conformes au protocole Stremio Addon.

Endpoints¶

Manifest¶

Méthode	URL	Description
`GET`	`/manifest.json`	Manifest public (sans auth)
`GET`	`/{config}/manifest.json`	Manifest avec préférences utilisateur

Configuration¶

Méthode	URL	Description
`GET`	`/configure`	Page de configuration HTML
`GET`	`/{config}/configure`	Page de config avec config existante

Recherche¶

Méthode	URL	Description
`GET`	`/{config}/stream/{type}/{id}`	Recherche principale

Catalogue & Métadonnées¶

Méthode	URL	Description
`GET`	`/{config}/catalog/{type}/{id}.json`	Catalogue Stremio
`GET`	`/{config}/catalog/{type}/{id}/skip={skip}.json`	Catalogue paginé
`GET`	`/{config}/meta/{type}/{id}.json`	Métadonnées enrichies

Lecture¶

Méthode	URL	Description
`GET/HEAD`	`/playback/{config}/{query:path}`	Proxy de lecture

Pipeline de recherche¶

graph TD
 A["Requête Stremio<br/>/{config}/stream/{type}/{id}"] --> B{" Cache Redis<br/>TTL: 7j"}
 B -->|Hit| Z["Réponse immédiate"]
 B -->|Miss| C{" Cache PostgreSQL<br/>Quantité + fraîcheur"}
 C -->|Suffisant| D["Réponse + refresh async"]
 C -->|Insuffisant| E["Meilisearch<br/>Torrents publics"]
 E --> F["Indexeurs privés<br/>C411, Torr9..."]
 F --> G["Fusion + Filtrage<br/>VF/VOSTFR, qualité"]
 G --> H["Vérification debrid<br/>RD, AD, TB..."]
 H --> I["Mise en cache<br/>Redis + PostgreSQL"]
 I --> J["Préchargement<br/>Épisode N+1"]
 J --> Z

 style A fill:#311b92,color:#fff
 style Z fill:#1b5e20,color:#fff

Paramètres de recherche¶

Paramètre	Type	Description
`config`	`str`	Token Fernet encodé (préférences + clé API)
`type`	`str`	`movie` ou `series`
`id`	`str`	ID du contenu (`tmdb:{id}` ou `tt{id}`)

Exemple de réponse¶

{
  "streams": [
    {
      "name": "StreamFusion",
      "title": "Film (2024) - TRUEFRENCH 1080p",
      "url": "https://...",
      "behaviorHints": {
        "filename": "Film.2024.TRUEFRENCH.1080p.mkv"
      }
    }
  ]
}

Lecture (Playback)¶

Le proxy de lecture gère le rate limiting et l'option de proxification :

En-tête	Description
`X-Playback-Limit`	Limite de requêtes par fenêtre
`X-Playback-Remaining`	Requêtes restantes
`X-Playback-Reset`	Timestamp de réinitialisation

Configuration via :

PLAYBACK_LIMIT_REQUESTS=60    # Max requêtes par fenêtre
PLAYBACK_LIMIT_SECONDS=60     # Durée de la fenêtre (s)