O Threads suporta o protocolo ActivityPub, permitindo que suas postagens públicas sejam compartilhadas em plataformas federadas como Mastodon e Pixelfed. Para habilitar esse compartilhamento, outros servidores precisam descobrir sua conta do Threads usando um padrão chamado Webfinger. O endpoint Webfinger no Threads retorna um descritor de recurso JSON que inclui a URI do ator ActivityPub. Este artigo de referência explica o formato exato da URL do endpoint Webfinger do Threads, a estrutura da URI da conta e como consultar qualquer conta pública do Threads a partir de um servidor federado.

Você aprenderá o padrão correto de URL para a consulta Webfinger, o formato da URI acct e como a resposta mapeia para o endereço do ator ActivityPub. Esta informação é útil para desenvolvedores que criam ferramentas multiplataforma, para usuários verificando o status de federação de suas contas e para administradores de servidores solucionando problemas quando um perfil do Threads não aparece no Mastodon.

Principais Conclusões: Webfinger do Threads e Formato da URI da Conta

URL do endpoint Webfinger: https://www.threads.net/.well-known/webfinger?resource=acct:USERNAME@threads.net — consulte qualquer conta pública do Threads
Formato da URI da conta: acct:USERNAME@threads.net — o identificador ActivityPub padrão para um usuário do Threads
Campo subject da resposta: Retorna acct:USERNAME@threads.net como o identificador principal da conta

O Que É o Endpoint Webfinger do Threads e Por Que Ele Importa

Webfinger é um protocolo definido na RFC 7033 que permite a um servidor descobrir informações sobre uma conta com base em um identificador semelhante a um e-mail. No ecossistema ActivityPub, o Webfinger é o primeiro passo para resolver um identificador de usuário como @username@threads.net em uma URL completa do ator ActivityPub. Quando um servidor Mastodon deseja seguir ou buscar um usuário do Threads, ele envia uma solicitação Webfinger para o Threads e recebe um documento JSON que contém o endpoint do ator ActivityPub do usuário.

O endpoint Webfinger no Threads está hospedado em um caminho padrão sob o domínio threads.net. O endpoint aceita um parâmetro de consulta resource que deve ser uma URI válida no esquema acct:. A resposta inclui um campo subject que ecoa o recurso solicitado e um array de links que apontam para o perfil ActivityPub do usuário e outros serviços.

Especificações Técnicas do Endpoint

O endpoint Webfinger usa HTTPS e retorna o tipo de conteúdo JSON application/jrd+json. O servidor não requer autenticação para consultar uma conta pública. Se a conta for privada ou não existir, o endpoint retorna HTTP 404 ou uma resposta de erro JSON. O endpoint suporta CORS, permitindo que aplicações JavaScript do lado do cliente o consultem diretamente de um navegador.

Regras de Formato da URI da Conta

A URI da conta para um usuário do Threads segue o padrão acct:USERNAME@threads.net. O nome de usuário é o mesmo que o identificador do Threads sem o símbolo @. A URI é insensível a maiúsculas/minúsculas na parte do domínio, mas os nomes de usuário no Threads são sensíveis a maiúsculas/minúsculas. O esquema acct: é obrigatório. Um exemplo válido é acct:zuck@threads.net para a conta de Mark Zuckerberg.

Como Consultar o Endpoint Webfinger do Threads

Você pode consultar o endpoint Webfinger usando qualquer cliente HTTP, incluindo um navegador, curl ou uma linguagem de programação. A solicitação deve ser um GET para a URL well-known com o parâmetro resource. Abaixo estão as etapas exatas para realizar uma consulta manual.

Obtenha o nome de usuário do Threads
Encontre o nome de usuário exato da conta que você deseja consultar. Por exemplo, se a URL do perfil for https://www.threads.net/@zuck, o nome de usuário é zuck.
Construa a URL Webfinger
Use o formato https://www.threads.net/.well-known/webfinger?resource=acct:USERNAME@threads.net. Substitua USERNAME pelo nome de usuário real. Exemplo: https://www.threads.net/.well-known/webfinger?resource=acct:zuck@threads.net.
Envie a solicitação GET
Abra a URL em um navegador ou use curl na linha de comando: curl -H "Accept: application/jrd+json" "https://www.threads.net/.well-known/webfinger?resource=acct:zuck@threads.net".
Analise a resposta
A resposta JSON contém um campo subject com a URI acct e um array links. O link com rel: "self" e type: "application/activity+json" fornece a URL do ator ActivityPub, que geralmente é https://www.threads.net/@USERNAME.

Exemplo de Resposta Webfinger

Uma resposta bem-sucedida para acct:zuck@threads.net retorna JSON semelhante à seguinte estrutura (simplificada):

{
  "subject": "acct:zuck@threads.net",
  "links": [
    {
      "rel": "self",
      "type": "application/activity+json",
      "href": "https://www.threads.net/@zuck"
    }
  ]
}

O campo href no link self é a URI do ator ActivityPub que outros servidores usam para buscar o perfil e as postagens do usuário.

Problemas Comuns ao Consultar o Webfinger do Threads

Consulta Retorna HTTP 404 para um Nome de Usuário Válido

Se o endpoint Webfinger retornar um status 404, a conta pode estar configurada como privada. O Threads só expõe dados Webfinger para perfis públicos. Verifique a configuração de privacidade da conta no Threads. Se a conta for pública e ainda assim retornar 404, o nome de usuário pode conter caracteres especiais ou espaços no início/fim. Certifique-se de que o nome de usuário na URI acct corresponda exatamente ao identificador mostrado na página do perfil.

Webfinger Retorna um Subject Diferente do Solicitado

Em casos raros, o campo subject pode diferir ligeiramente do recurso solicitado. Isso pode acontecer se o nome de usuário contiver letras maiúsculas que o servidor normaliza. Por exemplo, solicitar acct:Zuck@threads.net pode retornar acct:zuck@threads.net no subject. Essa normalização é padrão e não afeta a funcionalidade.

A URL do Ator ActivityPub Não Carrega

O href do link self retornado pelo Webfinger aponta para a página do perfil do usuário no Threads. Essa página é um documento HTML, não um JSON bruto do ActivityPub. Para buscar o objeto do ator ActivityPub, o servidor solicitante deve enviar um HTTP GET com o cabeçalho Accept: application/activity+json. Sem esse cabeçalho, o servidor retorna a página HTML. Isso é proposital e corresponde ao comportamento do Mastodon e de outras plataformas.

Webfinger do Threads vs Webfinger do Mastodon

Item	Threads	Mastodon
URL do endpoint Webfinger	https://www.threads.net/.well-known/webfinger	https://mastodon.example/.well-known/webfinger
Formato da URI da conta	acct:USERNAME@threads.net	acct:USERNAME@mastodon.example
Tipo rel do link self	application/activity+json	application/activity+json
Formato do href do link self	https://www.threads.net/@USERNAME	https://mastodon.example/@USERNAME
Tratamento de conta privada	Retorna HTTP 404	Retorna HTTP 404 ou array links vazio

Esta referência fornece os padrões exatos de URL e formato de resposta necessários para consultar qualquer conta pública do Threads via Webfinger. Use a URL do endpoint e o formato da URI acct mostrados acima para integrar a descoberta do Threads em suas próprias ferramentas ou para verificar se sua conta está devidamente federada. Para uso avançado, observe que o href do link self é o mesmo que a URL do perfil do usuário e requer o cabeçalho de tipo de conteúdo ActivityPub para retornar o objeto do ator bruto.

← Voltar ao Início Mais em Threads