Ir para a documentação
SparkGlimSparkGlim Programadores
Pesquisar em toda a documentação

Experimente um tema na sua língua ou um caminho API exato.

    Referência API

    Artigos publicados

    Lista artigos publicados com pesquisa, categoria, destaques e paginação exata.

    GEThttps://api.sparkglim.net/api/public/blog

    Modelo 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

    NomeTipoValidação
    categoryOpcional

    Categoria de campanha ou definições aprovadas conforme recurso.

    stringValidação: Identificador de categoria no URL.
    searchOpcional

    Filtro textual aplicado aos registos publicados selecionados.

    stringValidação: Texto de pesquisa.
    featuredOpcional

    Ativa filtro de artigos destacados com valor true.

    stringValidação: true.
    limitOpcional

    Máximo de registos na página; aplica-se o limite fixo do endpoint.

    numberValidação: 1–30; valor predefinido: 10.
    offsetOpcional

    Número de artigos publicados a ignorar antes da página, a partir de zero.

    numberValidaçã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
    GET /api/public/blog HTTP/1.1
    Host: api.sparkglim.net
    

    Resposta

    Resposta de sucesso · HTTP 200
    json
    {
      "success": true,
      "data": [],
      "count": 0,
      "limit": 10,
      "offset": 0
    }
    Resposta de erro · HTTP 400
    json
    {
      "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.ts
    • server/src/api/routes/public.ts