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

    Enviar comentário moderado

    Envia comentário de perfil verificado segundo definições do artigo e moderação.

    POSThttps://api.sparkglim.net/api/public/blog/:slug/comments

    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.

    Exige perfil verificado; pode ficar pendente. Não implica API pública de criação de identidades.

    Parâmetros

    NomeTipoValidação
    slugObrigatório

    Identificador de URL da campanha ou artigo publicado existente.

    stringValidação: Identificador URL público.

    Pedido

    NomeTipoValidação
    contentObrigatório

    Comentário de perfil comunitário verificado; aplica-se moderação.

    stringValidação: 2–4000.
    profileTokenObrigatório

    Token de perfil comunitário verificado existente; este endpoint não cria identidade.

    stringValidação: Perfil de comunidade existente e verificado, exigido pelo controlador.

    Pedido

    Os exemplos descrevem o contrato e não são executados. Use registos de teste autorizados; nunca cole segredos reais aqui.

    POST /api/public/blog/:slug/comments
    http
    POST /api/public/blog/example-campaign/comments HTTP/1.1
    Host: api.sparkglim.net
    Content-Type: application/json
    
    {
      "content": "Example comment text.",
      "profileToken": "<VERIFIED_COMMUNITY_PROFILE_TOKEN>"
    }

    Resposta

    Resposta de sucesso · HTTP 200
    json
    {
      "success": true,
      "moderated": true,
      "message": "Your comment is awaiting moderation."
    }
    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