O que a consulta retorna
Campos que merecem atenção
- identificações de histórias
- ordem da lista
- referência pública
Hacker News API
Mostra a lista atual de histórias mais votadas no Hacker News, útil como ponto de partida para explorar discussões técnicas.
Resposta pública atual
Carregue uma nova resposta de Hacker News API; não é necessário digitar um termo.
A lista topstories contém somente IDs
/v0/topstories.json devolve uma sequência de identificações numéricas, em ordem de exibição no Hacker News. A documentação informa que pode haver até 500 histórias principais e que a lista também pode conter vagas. Um ID não traz título, link, autor, pontuação ou comentário até que você consulte o item correspondente.
- Use cada número em /v0/item/{id}.json para abrir uma história.
- Não trate a posição na resposta como ranking permanente.
- Filtre type quando a interface não quiser mostrar vagas.
O item explica o que está sendo exibido
Uma história pode trazer id, type, by, time, title, url, score, descendants e kids. type distingue story, job, comment, poll e pollopt. time é Unix time; title e text podem conter HTML; descendants é o total de comentários de uma história ou enquete, e kids lista seus comentários diretos em ordem de exibição.
- Converta time antes de exibir uma data humana.
- Sanitize title e text ao renderizar HTML vindo da fonte.
- Use url como destino externo quando existir; nem toda história tem URL própria.
Popularidade não verifica a fonte externa
A API disponibiliza dados públicos do Hacker News quase em tempo real. score mostra o placar da comunidade e muda com o tempo; ele não confirma a exatidão da página vinculada. Abra a URL original, leia a discussão e diferencie opinião, anúncio, demonstração e reportagem antes de repetir uma afirmação como fato.
- Consulte o item novamente quando a posição ou a pontuação for importante.
- Não use número de comentários como medida de qualidade técnica.
- Indique Hacker News e a página original ao encaminhar uma história.