grade

 ⟨36 unchanged words⟩ POST /api/contact para apresentar o projeto. O envio poré APIlivre mantém— osem gatecaptcha x402nem oupagamento crédito—, pré-pago;uma omensagem formulárioa humanocada usa10 Turnstile.s por rede.

DescobreÍndice aauto-descrito da API Grade.inteira, com os idiomas e as páginas HTML de cada um.

Preços e tetos. É o número EM VIGOR: leia daqui antes de gastar chamada, em vez de assumir o preço da documentação. Com credencial, também diz se o passe de chat de quem fala no chat (o convidado; sem ele, a conta) está ativo. `prices.abuso_24h_usd` é o preço da porta de UA vazio/curl, hoje desligada.

 ⟨5 unchanged words⟩ de sucesso, motivos de falha e ambientes afetados. É o que separa 'o canal está fora do ar' de 'o canal está bloqueado no seu país'. `geo` diz se é restrição regional ou falha geral (com os países), `regions[]` traz sucesso/falha por país, `latency[]` a velocidade de abertura medida no hop por país, e `pra_voce` resume tudo para o país de quem chama. Sem relato da comunidade (`POST /api/play-report`) o painel fica vazio.

 ⟨10 unchanged words⟩  que fala no chat. Sem pagamento → 402. Passe já válido devolve 200 sem cobrar de novo — dá para chamar antes de escrever, sem risco de pagar duas vezes. O passe é de quem fala no chat: o convidado de `X-Guest-Token` (é ele que o WebSocket reconhece no `hello`); sem convidado, a sessão da conta, que fala só por HTTP. Fica no registro global de compras (`direito`).

Manda mensagem na sala de um canal por HTTP. Ler é grátis; escrever custa $0.10 por 30 dias. Sem passe válido a resposta é 402 com `accepts[]` — pague e repita a mesma chamada. Quem fala é o convidado (`X-Guest-Token`), o mesmo que o WebSocket reconhece; sem convidado, a sessão da conta.

Limpa o histórico inteiro do dono.dono, de uma vez.

 ⟨12 unchanged words⟩ . Após o 1º envio: 429 + Retry-After. Projetos de produtores: consulte GET /api/producers e use contact.message_template na mensagem. O primeiro envio de agente sai sem espera, após pagamento; depois o backoff é 60s dobrando até 1 hora (`Retry-After`). O valor paga somente o envio do contato, não o serviço de transmissão.

Cria tab/categoria pessoal. Teto de 8 pastas por dono. A resposta traz a biblioteca inteira já atualizada — não precisa recarregar `GET /api/library` depois.

Cria sub-aba numa categoria. Teto de 12 sub-abas por pasta. A resposta traz a biblioteca inteira já atualizada — não precisa recarregar `GET /api/library` depois.

Cria guest ipt_… Não pede e-mail nem nada. Guarde o token: perdeu o token, perdeu a biblioteca — a não ser que a conta já o tenha reivindicado (`POST /api/auth/claim`), e aí o que ele guardou está na conta.

Apaga um comentário do próprio dono. O 404 é de propósito: a API não confirma que existe um comentário com aquele id se ele não é seu.

País sugeridoe idioma sugeridos para aquem UIestá (fallbackchamando. Sem país detectado pela borda, sugere BR). com `source: "fallback"`; `detected` diz o que a borda viu.

DetalheFicha completa de um canal, ecom seusos streams.streams já apontando para o nosso hop.

 ⟨7 unchanged words⟩ nós): agora, a seguir e a lista. Disponível nos canais com guia (`guide=1`), com validade de até dois dias. Confira a data da resposta; a ficha traz o resumo em `guide_now`.

Histórico de canais assistidos pelo dono. Exibe somente canais disponíveis no catálogo.

ÁrvoreA organizadagaleria inteira do dono: +pastas, sub-abas, canais e as URLs de feed.feed de cada nível.

Liveness.Liveness e o commit publicado agora — é como o smoke espera o próprio deploy.

 ⟨10 unchanged words⟩  copiar em outro player e player legado HTTP. O botão legacy_url abre http://legacy.gradetv.net:8080/legacy?stream=ID. A página isolada aceita lang=pt/en/es/fr/de e theme=light/dark. Playlists continuam pelo hop HTTPS e mídia direto da origem. Não remove recusa de acesso nem exigência CORS. Uma leitura indexada; não busca origem nem grava no D1.

Cidades comque têm canal tocável.tocável, filtráveis por país e por estado.

Comentários da comunidade sobre um canal. Com credencial na chamada, cada comentário seu vem com `mine: true` — é assim que a interface sabe o que dá para apagar.

Favoritos do dono. Exibe somente canais disponíveis no catálogo.

Idiomas doque catálogotêm tocável.canal tocável, com a contagem de cada um.

Redes (network)e doemissoras catálogoque tocável.têm canal tocável, com a contagem.

Qualidades distintas dosencontradas streams.nos streams do catálogo (em rádio, codec e bitrate).

Estados/subdivisõesEstados come províncias que têm canal tocável.

 ⟨8 unchanged words⟩ ): e-mail e tamanho da biblioteca da conta. A conta é a da biblioteca de conta; `user.id` é o id da conta, e é ele o dono da galeria com sessão.

 ⟨10 unchanged words⟩ (METRICS_TOKEN). Use para investigar um canal específico. Existe separado do painel público justamente porque traz endereço. A linha some depois do prazo em `retention_days`, e `/api/channels/:id/health` nunca devolve IP.

Comenta num canal (teto de 20/hora por dono). Sem `author`, o apelido é gerado e fica estável para o mesmo dono — a pessoa não vira um nome diferente a cada mensagem.

 ⟨6 unchanged words⟩  informações e contatos para produtores. Não ativa streams. Somente informações e captação de interesse. Não provisiona, não cobra e não ativa transmissão. Use contact.form_url no browser, contact.email por e-mail ou POST /api/contact para apresentar o projeto. O envio por API mantém o gate x402 ou crédito pré-pago; o formulário humano usa Turnstile.

TiraDesfavorita umo canal dose favoritosdevolve doo dono.ponto ao contador público.

 ⟨14 unchanged words⟩ e país saem do pedido, não do corpo. Conta uma vez por dono, por canal, por dia e por resultado; relatar de novo devolve 200 com `reason: ja_relatado_hoje`, e não é erro. Navegador e sistema saem do User-Agent e o país da borda — mandar isso no corpo não muda nada. Sem relato, o catálogo não aprende: é assim que `GET /api/channels/:id/health` sabe distinguir canal fora do ar de canal bloqueado para você.

 ⟨36 unchanged words⟩  foi visto online nas últimas 48 h). É a porta de entrada do produto. A resposta varia por navegador, sistema e país de quem pede — cada canal traz `social.your_fails`, o recorte do SEU ambiente — por isso ela é `Cache-Control: private`.

País sugerido pelo Cloudflare para a UI (fallback BR).

{"properties":{"id":{"description":"ID do canal no iptv-orgcatálogo, ex. `GloboNews.br`.","type":"string"}} ⟨4 unchanged words⟩ 

{"properties":{"id":{"description":"ID do canal no iptv-org.catálogo.","type":"string"}},"required": ⟨3 unchanged words⟩ 

{"properties":{"id":{"description":"ID do canal no iptv-org.catálogo.","type":"string"}},"required": ⟨3 unchanged words⟩ 

 ⟨7 unchanged words⟩ ) conta canais de TV; `radio` conta estações do Radiode Browser;rádio; `all` junta os dois.","enum":[" ⟨7 unchanged words⟩ 

Tags das estações de rádio tocáveis (Radio Browser), com contagem; opcionalmente por país.

 ⟨31 unchanged words⟩ ":{"description":"ID do canal no iptv-org.catálogo.","type":"string"}},"required": ⟨4 unchanged words⟩ 

{"properties":{"category":{"description":"ID de categoria do iptv-org.catálogo.","type":"string"},"city":{"description":"Cidade, código do iptv-org.catálogo.","type":"string"},"country":{ ⟨35 unchanged words⟩ o catálogo de TV; `radio` são as estações do Radiode Browser;rádio; `all` junta os dois. Sem `kind`, rádio  ⟨29 unchanged words⟩ `1` traz só canal visto online pela fonte (IPTV Nexus para TV, Radio Browser para rádio) nas 48 h anteriores à última recarga do  ⟨66 unchanged words⟩ ":"`score` ordena pela saúde medida por terceiro (IPTV Nexus), melhor primeiro; canal não medido vai para o fim. `votes` ordena pelos votos da comunidaderegistrados dopara Radioa Browserestação (rádio). `name` é a ordem alfabética." ⟨6 unchanged words⟩ subdivision":{"description":"Estado/província, código do iptv-org.catálogo.","type":"string"},"tag":{"description":"Tag da estação de rádio (vocabulário livre do Radio Browser, ex. `mpb`, `news`); veja `GET /api/tags`. ⟨4 unchanged words⟩ 

 ⟨3 unchanged words⟩ ":"ID do canal no iptv-org, ex. `Globo.br`.`GloboNews.br`.","type":"string"}},"required": ⟨3 unchanged words⟩ 

{"properties":{"channel_id":{"description":"Canal assistido, ex. `Globo.br`.`GloboNews.br`.","type":"string"}},"required": ⟨3 unchanged words⟩ 

 ⟨2 unchanged words⟩ :{"description":"Canal a desfavoritar, ex. `Globo.br`.`GloboNews.br`.","type":"string"}},"required": ⟨3 unchanged words⟩