Integre o catálogo e o player do SlixHub.

Visão geral

Um fluxo com duas superfícies

O catálogo entrega metadados e a URL pública de reprodução. O player recebe o usuário, escolhe as fontes disponíveis e protege os detalhes internos de mídia.

1. 1
   Consulte

   Busque qualquer tipo de título em https://api.slixhub.ru/catalog.

2. 2
   Escolha

   Use o campo player_url retornado para o título.

3. 3
   Reproduza

   Abra o link ou incorpore-o em um iframe responsivo.

Quick start

Do catálogo ao play

Faça a consulta pelo backend do seu projeto, selecione um item e encaminhe o player_url

const response = await fetch(
  "https://api.slixhub.ru/catalog?type=all&page=1"
);

if (!response.ok) throw new Error("Catalog request failed");

const { items } = await response.json();
const title = items[0];

console.log(title.title, title.player_url);

API de catálogo

Listar e filtrar títulos

curl "https://api.slixhub.ru/catalog?type=anime&sort=random&seed=20260826&page=1"

Formato da resposta

Metadados e URL pública

A resposta é paginada. Somente títulos ativos com identidade pública e ao menos uma fonte disponível entram na listagem em produção.

{
  "items": [
    {
      "id": "movie:550",
      "tmdb_id": 550,
      "imdb_id": "tt0137523",
      "external_ids": [],
      "kind": "movie",
      "type_label": "Filme",
      "title": "Título de exemplo",
      "original_title": "Example title",
      "overview": "Sinopse do título.",
      "tagline": "Frase de destaque.",
      "poster_url": "https://image.tmdb.org/...",
      "backdrop_url": "https://image.tmdb.org/...",
      "year": 2026,
      "genres": ["Drama", "Ficção científica"],
      "meta_label": "118 min",
      "server_count": 2,
      "player_url": "https://embed.slixhub.ru/movie/550"
    }
  ],
  "page": 1,
  "page_size": 24,
  "total": 84,
  "has_more": true,
  "sort": "random",
  "seed": 20260826
}

id

Chave pública textual, como movie:550, serie:tt0903747 ou minidrama:{provider}:{provider_id}. Não é a chave interna do banco.

external_ids

Lista de pares provider e provider_id. TMDB e IMDb possuem também os campos tmdb_id e imdb_id, que podem ser nulos.

kind

Identifica o tipo técnico usado pelo título.

meta_label

Texto pronto para exibição, como duração ou temporadas.

server_count

Quantidade de fontes atualmente disponíveis.

player_url

URL recomendada para assistir ou incorporar.

seed

Repita o valor retornado ao buscar outras páginas de uma ordem aleatória.

Player e embed

Use sempre o player_url

O campo retornado pela API já considera o domínio público configurado para o player. Filmes abrem diretamente, MiniDramas abrem no feed vertical de episódios e séries, animes e doramas usam a navegação por temporadas.

<div style="position:relative;aspect-ratio:16/9">
  <iframe
    src="https://embed.slixhub.ru/movie/550"
    title="Player SlixHub"
    allow="autoplay; fullscreen; picture-in-picture"
    allowfullscreen
    style="position:absolute;inset:0;width:100%;height:100%;border:0"
  ></iframe>
</div>

Detalhes e identificadores

Consulte cada título pela identidade pública

A listagem retorna items; cada rota de detalhe retorna um único título. Use o identificador externo correspondente ao tipo de conteúdo:

GET https://api.slixhub.ru/catalog/movie/{tmdb_id_ou_imdb_id}
GET https://api.slixhub.ru/catalog/serie/{tmdb_id_ou_imdb_id}
GET https://api.slixhub.ru/catalog/minidrama/{provider}/{provider_id}
GET https://api.slixhub.ru/catalog?type=minidrama&provider={provider}&provider_id={provider_id}

O que vem no detalhe

Filme

Retorna sources[] com as fontes disponíveis.

Série, anime, dorama e MiniDrama

Retornam seasons[], cada uma com season_number e episodes[].

Episódio

Informa episode_number, name, available, external_ids[], sources[] e player_url. Abra esse URL para assistir; os números finais da rota são a temporada e o episódio.

Qual ID usar

Título id

Chave pública textual, nunca o ID interno. Rotas de filmes e séries usam TMDB numérico ou IMDb iniciado por tt.

MiniDrama provider_id

ID textual do título no provedor. Versões localizadas podem ter identidades diferentes.

Episódio external_ids[]

O provider_id identifica o episódio no provedor, como um chapter_id. Pode estar vazio em registros antigos.

Fonte sources[].public_id

Identifica a mídia standalone. playback_mode indica a rota e video_type indica o formato de reprodução.

Legenda externa

Quando disponível, sources[].subtitle informa url, language, label, enabled e hls. O idioma padrão é pt-BR; o player permite desligar a faixa ou escolher outra faixa oferecida pela playlist HLS.

Produção

Checklist antes de publicar

• Consuma o catálogo no backend quando o frontend estiver em outro domínio.
• Persista a chave textual id e as identidades externas; use o player_url mais recente para reproduzir.
• Mantenha o iframe responsivo e permita autoplay, fullscreen e picture-in-picture.
• Trate listas vazias e itens removidos sem quebrar a navegação do seu produto.
• Em sort=random, preserve a mesma seed durante toda a paginação.
• Não armazene nem tente acessar URLs internas de mídia ou tokens temporários.

Erros

Respostas que a integração deve tratar