API · Version v0

Referência da API pública

Rotas de leitura do Eureka42 para notícias, tags, busca, biblioteca e publicações, com parâmetros aceitos.

This page is not translated into this language yet; showing it in Português.

Todas as rotas começam em /api/v1 e aceitam apenas GET. Escrita (CMS, fórum, administração) exige sessão, MFA quando aplicável e permissões; não faz parte desta referência.

Notícias

GET /articles?locale=pt-BR&section=&limit=20: notícias publicadas. locale é obrigatório; limit vai de 1 a 50.
GET /articles/:locale/:slug: uma notícia com fontes.

Tags e busca

GET /tags: tags com notícias publicadas.
GET /tags/:slug?locale=pt-BR: notícias de uma tag.
GET /search?q=termo&locale=pt-BR: até 20 resultados entre notícias publicadas. Limite de 60 consultas por minuto por IP.

Biblioteca

GET /library?locale=pt-BR: catálogo publicado.
Filtros combináveis: category, maturity (experimental, beta, stable, deprecated), runtime e language.
Paginação: limit (1 a 200, padrão 200) e offset (a partir de 0). A ordem é estável entre páginas.
GET /library/:slug?locale=pt-BR: ficha completa. O comando de instalação só aparece quando há release confirmado no registro do npm.

Publicações

GET /publications?locale=pt-BR&type=article: artigos, e-books e livros publicados (type opcional: article, ebook, book).
GET /publications/:slug: obra com licença. Obras abertas trazem license (código, URL e atribuição).
GET /publications/:slug/file: PDF da obra aberta, com cabeçalho link apontando para a licença.

Os erros seguem o formato de Erros e limites.