Referência API
Artigos publicados
Lista artigos publicados com pesquisa, categoria, destaques e paginação exata.
https://api.sparkglim.net/api/public/blogModelo de acesso
- Modelo de acesso
- Acesso público com validação
- Disponibilidade documentada
- Implementado no código
Disponibilidade verificada no código, sem garantia de produção.
Abra o URL de pagamento devolvido. O SparkGlim Server controla preços, métodos, verificação e entrega; o regresso do navegador apenas navega.
Parâmetros
| Nome | Tipo | Validação |
|---|---|---|
categoryOpcionalCategoria de campanha ou definições aprovadas conforme recurso. | string | Validação: Identificador de categoria no URL. |
searchOpcionalFiltro textual aplicado aos registos publicados selecionados. | string | Validação: Texto de pesquisa. |
featuredOpcionalAtiva filtro de artigos destacados com valor true. | string | Validação: true. |
limitOpcionalMáximo de registos na página; aplica-se o limite fixo do endpoint. | number | Validação: 1–30; valor predefinido: 10. |
offsetOpcionalNúmero de artigos publicados a ignorar antes da página, a partir de zero. | number | Validação: >=0; valor predefinido: 0. |
Pedido
Os exemplos descrevem o contrato e não são executados. Use registos de teste autorizados; nunca cole segredos reais aqui.
GET /api/public/blog HTTP/1.1
Host: api.sparkglim.net
Resposta
{
"success": true,
"data": [],
"count": 0,
"limit": 10,
"offset": 0
}{
"success": false,
"error": "<ERROR_MESSAGE>"
}Validação, permissões, registos indisponíveis e falhas usam estado HTTP e erro do controlador.
Limites e novas tentativas
Limite padrão: 100 pedidos por IP em 60 segundos. Aplicam-se também controlos específicos.
Compatibilidade do código
As operações autorizadas exigem testes específicos da conta.
server/src/api/router.tsserver/src/api/routes/public.ts