ForHosting KIT · Monitorar sites

Crie uma tag de descoberta para RSS, Atom ou JSON Feed

A descoberta de feeds funciona melhor quando uma página informa explicitamente a navegadores, leitores e rastreadores onde está seu recurso de distribuição.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Este gerador recebe um tipo de feed e uma URL absoluta, seleciona o tipo de mídia correspondente, escapa caracteres que poderiam quebrar um atributo HTML e devolve um elemento link rel alternate completo, pronto para o head. Ele aceita RSS, Atom e JSON Feed e rejeita formatos desconhecidos ou URLs inválidas que não sejam da web.

Escolha o formato correspondente ao documento publicado

Uma tag de descoberta só é útil quando o atributo type descreve corretamente o recurso indicado pela URL. Selecione rss para um documento RSS em XML, atom para Atom em XML ou json-feed para um documento JSON Feed. O gerador associa essas opções, respectivamente, a application/rss+xml, application/atom+xml e application/feed+json. Ele não examina nem baixa o destino, portanto o formato selecionado precisa corresponder ao conteúdo realmente entregue pelo seu servidor. Uma declaração precisa ajuda os leitores a decidir se entendem o recurso antes de buscá-lo ou analisá-lo. Também evita erros comuns de copiar e colar, como anunciar um endpoint Atom com o tipo de RSS ou expor JSON Feed como JSON genérico. Nomes desconhecidos são recusados, e não presumidos, porque um tipo plausível, porém incorreto, torna a descoberta mais difícil de diagnosticar. Se o site oferecer vários formatos, execute o gerador para cada endpoint e coloque todos os elementos resultantes no head. Cada tag representará uma alternativa verdadeira que um cliente compatível poderá escolher.

Informe a URL pública e canônica do feed

Digite uma URL absoluta HTTP ou HTTPS que o leitor de feed de um visitante possa acessar, como https://example.com/feed.xml. URLs absolutas são preferíveis em metadados de descoberta porque páginas copiadas, documentos em cache e clientes com comportamentos diferentes para a URL base continuam apontando para o mesmo endpoint. O gerador remove espaços externos, verifica se o valor pode ser interpretado como URL e recusa esquemas como file, data ou javascript. Ele preserva o endereço fornecido em vez de reescrever silenciosamente caminho, consulta, fragmento, escapes ou maiúsculas. Caracteres especiais dentro de um atributo HTML são codificados no markup gerado; assim, um e comercial na consulta se torna seguro sem alterar o campo url devolvido. A validação confirma formato e esquema, mas não propriedade, disponibilidade, tipo de conteúdo, redirecionamentos ou TLS. Teste o endpoint publicado separadamente e confira se ele retorna o feed pretendido com sucesso. Ao mover um feed, atualize o redirecionamento no servidor e esta tag de descoberta.

Insira e confira o elemento gerado

Copie a tag devolvida para o head da página HTML cujo feed você deseja tornar detectável. O resultado usa rel="alternate", o tipo de mídia específico do formato e a URL escapada como href. O atributo title é omitido de propósito porque a entrada contém apenas formato e URL; inventar uma descrição seria menos útil do que permitir que você escolha idioma e redação no próprio template. Se o site tiver vários feeds, como um principal e outros por assunto, crie um elemento para cada URL e adicione títulos claros no código da aplicação quando os usuários precisarem diferenciá-los. Confira o código-fonte efetivamente entregue depois da implantação, pois um template ou uma camada de segurança pode transformar o markup mesmo quando o valor gerado está correto. Depois, teste a descoberta com pelo menos um leitor e examine os cabeçalhos de resposta do endpoint. A ferramenta no navegador e a API executam a mesma função determinística, portanto entradas iguais produzem os mesmos campos e a mesma tag. Builds automatizados podem chamar a API por US$ 0,002 por solicitação; o uso interativo roda localmente no navegador.

Casos de uso

Adicionar descoberta RSS a uma publicação

Gere o elemento do head para o endpoint RSS de um blog ou portal de notícias sem decorar o tipo de mídia.

Anunciar uma alternativa Atom

Crie markup de descoberta consistente para um feed Atom oferecido junto com outros formatos de distribuição.

Publicar metadados de JSON Feed

Use o tipo de mídia registrado de JSON Feed em um elemento alternate com escape correto.

Perguntas frequentes

Quais tipos de feed são aceitos?

Os valores permitidos são rss, atom e json-feed. Qualquer outro valor gera um erro de entrada inválida.

Quanto custa uma solicitação pela API?

Cada solicitação pela API custa US$ 0,002. A versão para navegador roda localmente sem custo.

A ferramenta verifica se o feed existe?

Não. Ela valida a entrada e monta o markup sem fazer nenhuma solicitação de rede.

Por que a URL precisa ser absoluta?

Uma URL HTTP ou HTTPS absoluta permanece inequívoca para leitores, independentemente da página ou URL base em que foi encontrada.

Caracteres especiais na URL ficam seguros?

Sim. Caracteres especiais para atributos HTML recebem escape na tag, enquanto o campo url separado preserva a entrada sem espaços externos.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/web/link-rel-alternate-build

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/web/link-rel-alternate-build \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"feed_type":"rss","url":"https://example.com/feed.xml"}'

const res = await fetch("https://api.kit.forhosting.com/web/link-rel-alternate-build", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "feed_type": "rss",
    "url": "https://example.com/feed.xml"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/web/link-rel-alternate-build",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "feed_type": "rss",
    "url": "https://example.com/feed.xml"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/web/link-rel-alternate-build", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"feed_type":"rss","url":"https://example.com/feed.xml"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"feed_type":"rss","url":"https://example.com/feed.xml"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/web/link-rel-alternate-build", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "feed_type": "rss",
  "url": "https://example.com/feed.xml"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "web.link_rel_alternate_build",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

`timeout_sec`	30
`max_crawl_pages`	25

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →