Visão geral completa dos dados
Resumo de estado, previsões, sinais, histórico e metadados das fontes. Ideal como primeira requisição de um aplicativo.
01 / ENDPOINTS
JSONVisão geral dos endpoints
Escolha os dados conforme o uso e evite coletar várias vezes o mesmo anúncio da fonte original.
Sinais relacionados a resets
Filtra anúncios de reset, planos, indícios e notícias sobre limites nas publicações públicas, preservando a categoria e o estado de verificação.
Histórico de anúncios de reset
Anúncios de reset registrados; um anúncio de conclusão não verifica o limite de uso da conta local.
GET
/api/v1/tibo Publicações públicas do Tibo
Todas as publicações válidas registradas, com texto original, data de publicação, link e modo de coleta.
GET
/api/health Estado do serviço
Verifica a disponibilidade do serviço e das fontes de dados para sondas de implantação e tarefas agendadas.
Histórico permanente de publicações
Publicações originais e fontes armazenadas permanentemente, com paginação. Não há garantia de histórico completo anterior à primeira coleta.
Modelo experimental de probabilidade
Retorna a referência histórica, ajustes experimentais e impactos por publicação. As regras não são calibradas; a API de previsão original mantém a referência da fonte.
Campo:
/api/v1/overviewprobability_model → baseline / adjusted / factors / model_version / evaluated_attibo_history → total / persistent / complete_historyPARÂMETROS DE CONSULTA
Filtros e paginação
Aplica-se aos endpoints de listas signals, resets e tibo.
| Parâmetro | Descrição |
|---|---|
limit / offset | limit aceita 1–100, com padrão 50; offset começa em 0. A resposta retorna next_offset para obter a próxima página. |
kind | kind aceita reported_completed, planned, hint, limits, banked, unclear, needs_context ou other; type é um alias de compatibilidade. |
q | Busca por palavras-chave, com até 200 caracteres. |
from / to | Intervalo de datas UTC no formato YYYY-MM-DD. |
As respostas de listas incluem items, count, total, limit, offset e next_offset.Ver exemplo de filtro ↗
02 / INTERPRETAR A RESPOSTA
Verifique o estado antes de usar os dados.
| Campo | Como interpretar |
|---|---|
available | Indica se há um snapshot de dados disponível. Se não houver, exiba claramente o estado vazio. |
stale | Indica se os dados vêm de um cache desatualizado. Informe a idade dos dados mesmo quando conservar os registros. |
generated_at | Horário de geração desta resposta da API; não substitui o horário de publicação nem o horário de coleta do post. |
channels | Registra fetched_at, checked_at, a disponibilidade e os erros de cada fonte. |
posts | Texto original, URL original, horário de publicação, categoria e estado de verificação do post. |
quota_verified | Indica se o limite real da conta foi verificado. Se o valor for false, não exiba “Limite recuperado”. |
tibo.mode | x_api, third_party_copy ou unavailable distingue a coleta direta de cópias de terceiros. |
Os campos de previsão probability_24h / probability_48h são porcentagens entre 0–100. Se não houver previsão disponível, exiba um valor desconhecido; não substitua por 0%.
03 / INTEGRAÇÃO
Um exemplo mínimo de integração.
Os endpoints GET de leitura não exigem autenticação e permitem chamadas entre origens.
const response = await fetch(
'https://codexreset-news.com/api/v1/overview',
{ headers: { Accept: 'application/json' } }
);
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
if (!data.available) {
// Exiba “Dados indisponíveis”; não deduza que não houve um reset.
} else {
const posts = data.tibo?.items ?? data.posts ?? [];
const cached = data.stale === true;
// Exiba o link original e mantenha a atribuição dos dados de terceiros.
}Os endpoints de atualização da coleta exigem autenticação separada; o frontend não precisa ter a chave de coleta.Ver o estado atual do serviço ↗
04 / COMPATIBILIDADE
Compatível com as chamadas existentes.
Os endpoints antigos continuam fornecendo dados. Para novas integrações, use os endpoints versionados v1.