Executando verificação de segurança...
10

Breaking Change na API do TabNews sobre o objeto "Content"

Turma, tudo bem?

Gostaria de oficialmente anunciar uma breaking change na API do TabNews e antecipar outra que provavelmente estará por vir antes de oficializarmos a primeira versão estável dela, então vou separar o que vai acontecer em dois tópicos:

1) Breaking Change no objeto content

Como anunciado na publicação de melhorias, iremos renomear um campo no objeto content que é a propriedade username. Ela será renomeada para owner_username, pois é o username do dono do conteúdo, e não o username do conteúdo. Isto é uma alteração semântica para que as propriedades façam um par melhor, por exemplo:

  • owner_id
  • owner_username
  • parent_username

Neste exato momento, as propriedades username e owner_username estão sendo retornadas ao mesmo tempo no objeto content. Veja um exemplo ao vivo disso clicando aqui.

Mas a partir do dia 19 de Agosto, a propriedade username não estará mais disponível no objeto content e apenas irá permanecer a propriedade owner_username. Dado a isso, sugerimos que quem esteja utilizando a API do TabNew já mude a integração para utilizar a propriedade owner_username por já estar pública.

Caso queira acompanhar o progresso desta implementação, acompanhe essa issue*

2) Breaking Change na propriedade strategy (RFC)

Hoje o endpoint /api/v1/contents aceita 3 tipos de estratégia:

EstratégiaDescrição
/api/v1/contents?strategy=bestOrdena pelos conteúdos mais relevantes.
/api/v1/contents?strategy=newOrdena dos conteúdos mais novos para os mais antigos.
/api/v1/contents?strategy=oldOrdena dos conteúdos mais antigos para os mais novos.

Mas o nome da estratégia best não acredito ser o melhor e deveríamos mudar o nome para relevant, pois não são os melhores conteúdos e sim os mais relevantes para aquele momento. Isto fará um par muito melhor lá no menu principal superior, pois poderíamos colocar os itens Relevantes e Recentes.

Fora que a estratégia best poderia ser usada para ordenar as publicações apenas pelas tabcoins para um dia em específico. Por exemplo, mostrar qual foi a publicação mais popular do dia X.

O que acham?


⚠️ O repositório Open Source do TabNews ainda está em Modo Privado. Caso queira receber um convite para participar, leia esta publicação.

Carregando publicação patrocinada...
4

Faz sentido e até que concordo, era bom achar algo de 3~4 letras também para "igualar" com as outras estratégias.

E sobre a API, tá certo o CORS? Eu não consigo dar fetch mas acho que o problema ta aqui.

3

CORS habilitado e você já pode executar coisas como:

fetch('https://www.tabnews.com.br/api/v1/contents?per_page=1').then((r) => r.json()).then(console.log)
3
3
3

A relevância a gente está medindo pelo algoritmo que fizemos, que de forma grosseira é a quantidade de tabcoins dividida pelo tempo que passou (de forma exponencial). Então quanto mais antiga a publicação, exponencialmente maior vai ficando a gravidade que puxa ela para baixo.

Sobre o termo rank, eu gosto muito da ideia! Pois de fato define o ranking 🤝 único detalhe que isso não casaria muito bem com o nome no menu, ao menos acho que ficaria estranho colocar Rank ou Rankeados.