
Idioma 🇧🇷 Português (Brasil)
Documentação
Primeiros Passos
Referência da API
Uso
Agregação
Registros de auditoria
Autenticação
Bloquear comentário
Verificar comentários bloqueados
Comentários
Comentários para o usuário
Configurações de domínio
Modelos de e-mail
Registro de eventos
Publicações do Feed
Sinalizar comentário
GIFs
Hashtags
Moderação
Moderadores
Contagem de notificações
Notificações
Reações da página
Páginas
Eventos de webhook pendentes
Configurações de perguntas
Resultados de perguntas
Agregação de resultados de perguntas
Usuários SSO
Assinaturas
Uso diário do locatário
Pacotes do locatário
Usuários do locatário
Locatários
Tickets
Traduções
Enviar imagem
Progresso do distintivo do usuário
Distintivos do usuário
Notificações do usuário
Status de presença do usuário
Busca de usuários
Usuários
Votos
FastComments SDK para Nim
Este é o SDK oficial em Nim para o FastComments.
SDK oficial em Nim para a API do FastComments
Repositório
Instalação 
Usando Nimble
nimble install fastcomments
Compilando a partir do código-fonte
nimble build
Conteúdo da Biblioteca
Esta biblioteca contém o cliente de API gerado e as utilitários SSO para facilitar o trabalho com a API.
APIs Públicas vs Seguras
Para o cliente de API, existem três módulos de API, api_default, api_public e api_moderation. O api_default contém métodos que requerem sua chave de API, e o api_public contém chamadas de API que podem ser feitas diretamente de um navegador/dispositivo móvel/etc sem autenticação. O módulo api_moderation contém métodos para o painel de moderador.
O módulo api_moderation fornece um conjunto extenso de APIs de moderação em tempo real e rápidas. Cada método api_moderation aceita um parâmetro sso e pode autenticar via SSO ou um cookie de sessão do FastComments.com.
Início Rápido 
Usando APIs Autenticadas (DefaultAPI)
Importante: Endpoints autenticados requerem que sua chave de API seja definida no cabeçalho x-api-key.
import httpclient
import fastcomments
import fastcomments/apis/api_default
import fastcomments/models/model_comment_data
let client = newHttpClient()
client.headers["x-api-key"] = "your-api-key"
# Faça chamadas de API autenticadas.
# Parâmetros obrigatórios (e o corpo da requisição) são posicionais; opcionais
# parâmetros são passados via o objeto de opções da operação.
let (response, httpResponse) = getComments(
httpClient = client,
tenantId = "your-tenant-id",
options = GetCommentsOptions(
urlId: "your-url-id",
direction: SortDirections.DESC
)
)
if response.isSome:
let resp = response.get()
if resp.comments.isSome:
echo "Found ", resp.comments.get().len, " comments"
Usando APIs Públicas (PublicAPI)
Endpoints públicos não requerem autenticação:
import httpclient
import fastcomments
import fastcomments/apis/api_public
let client = newHttpClient()
# Faça chamadas de API públicas.
# tenantId e urlId são obrigatórios (posicionais); todo o resto é opcional.
let (response, httpResponse) = getCommentsPublic(
httpClient = client,
tenantId = "your-tenant-id",
urlId = "your-url-id",
options = GetCommentsPublicOptions(
direction: SortDirections.DESC
)
)
if response.isSome:
let resp = response.get()
if resp.comments.isSome:
echo "Found ", resp.comments.get().len, " comments"
Usando APIs de Moderação (ModerationAPI)
Endpoints de moderação alimentam o painel do moderador e são autenticados com um token SSO para o moderador em atuação:
import httpclient
import fastcomments
import fastcomments/apis/api_moderation
let client = newHttpClient()
# Listar comentários no painel de moderação.
# Esta operação não tem parâmetros obrigatórios, portanto tudo é opcional.
let (response, httpResponse) = getApiComments(
httpClient = client,
options = GetApiCommentsOptions(
count: 30,
tenantId: "your-tenant-id",
sso: "your-sso-token"
)
)
if response.isSome:
let resp = response.get()
echo "Found ", resp.comments.len, " comments"
Problemas Comuns
- Erro de autenticação 401: Certifique-se de definir o cabeçalho
x-api-keyno seu HttpClient antes de fazer requisições DefaultAPI:client.headers["x-api-key"] = "your-api-key" - Classe de API incorreta: Use
api_defaultpara requisições autenticadas do lado do servidor,api_publicpara requisições do lado do cliente/públicas, eapi_moderationpara requisições do painel de moderador.
Fazendo Chamadas de API 
All API methods in this SDK return tuples of (Option[ResponseType], Response). O primeiro elemento contém a resposta analisada se for bem‑sucedida, e o segundo elemento é a resposta HTTP bruta.
Required parameters and the request body are passed positionally. Os parâmetros opcionais restantes são reunidos em um único objeto Api<Operation>Options, que é o último argumento. Operations with no optional parameters take no options object.
Exemplo: Obtendo Comentários
import httpclient
import options
import fastcomments
import fastcomments/apis/api_default
let client = newHttpClient()
client.headers["x-api-key"] = "your-api-key"
let (response, httpResponse) = getComments(
httpClient = client,
tenantId = "your-tenant-id",
options = GetCommentsOptions(
urlId: "your-url-id",
direction: SortDirections.DESC
)
)
if httpResponse.code == Http200:
if response.isSome:
let resp = response.get()
if resp.comments.isSome:
echo "Found ", resp.comments.get().len, " comments"
Observações 
IDs de Broadcast
Você verá que deve passar um broadcastId em algumas chamadas de API. Quando receber eventos, você receberá esse ID de volta, então saberá ignorar o evento se planeja aplicar alterações de forma otimista no cliente
(o que você provavelmente vai querer fazer, já que oferece a melhor experiência). Passe um UUID aqui. O ID deve ser suficientemente único para não ocorrer duas vezes em uma sessão do navegador.
SSO (Login Único)
Para exemplos de SSO, veja abaixo.
Uso de SSO 
SSO Simples
import fastcomments/sso
let user = newSimpleSSOUserData(
userId = "user-123",
email = "user@example.com",
avatar = "https://example.com/avatar.jpg"
)
let sso = newSimple(simpleUserData = user)
let token = sso.createToken()
echo "SSO Token: ", token
SSO Seguro
import fastcomments/sso
let user = newSecureSSOUserData(
userId = "user-123",
email = "user@example.com",
username = "johndoe",
avatar = "https://example.com/avatar.jpg"
)
let apiKey = "your-api-key"
let sso = newSecure(apiKey = apiKey, secureUserData = user)
let token = sso.createToken()
echo "Secure SSO Token: ", token
Documentação do fastcomments 
Documentação dos Endpoints da API
All URIs are relative to https://fastcomments.com
| Classe | Método | Requisição HTTP | Descrição |
|---|---|---|---|
| DefaultApi | addDomainConfig | POST /api/v1/domain-configs | |
| DefaultApi | addHashTag | POST /api/v1/hash-tags | |
| DefaultApi | addHashTagsBulk | POST /api/v1/hash-tags/bulk | |
| DefaultApi | addPage | POST /api/v1/pages | |
| DefaultApi | addSSOUser | POST /api/v1/sso-users | |
| DefaultApi | aggregate | POST /api/v1/aggregate | Agrega documentos agrupando-os (se o parâmetro groupBy for fornecido) e aplicando múltiplas operações. Diferentes operações (por exemplo, sum, countDistinct, avg, etc.) são suportadas. |
| DefaultApi | aggregateQuestionResults | GET /api/v1/question-results-aggregation | |
| DefaultApi | blockUserFromComment | POST /api/v1/comments/{id}/block | |
| DefaultApi | bulkAggregateQuestionResults | POST /api/v1/question-results-aggregation/bulk | |
| DefaultApi | changeTicketState | PATCH /api/v1/tickets/{id}/state | |
| DefaultApi | combineCommentsWithQuestionResults | GET /api/v1/question-results-aggregation/combine/comments | |
| DefaultApi | createEmailTemplate | POST /api/v1/email-templates | |
| DefaultApi | createFeedPost | POST /api/v1/feed-posts | |
| DefaultApi | createModerator | POST /api/v1/moderators | |
| DefaultApi | createQuestionConfig | POST /api/v1/question-configs | |
| DefaultApi | createQuestionResult | POST /api/v1/question-results | |
| DefaultApi | createSubscription | POST /api/v1/subscriptions | |
| DefaultApi | createTenant | POST /api/v1/tenants | |
| DefaultApi | createTenantPackage | POST /api/v1/tenant-packages | |
| DefaultApi | createTenantUser | POST /api/v1/tenant-users | |
| DefaultApi | createTicket | POST /api/v1/tickets | |
| DefaultApi | createUserBadge | POST /api/v1/user-badges | |
| DefaultApi | createVote | POST /api/v1/votes | |
| DefaultApi | deleteComment | DELETE /api/v1/comments/{id} | |
| DefaultApi | deleteDomainConfig | DELETE /api/v1/domain-configs/{domain} | |
| DefaultApi | deleteEmailTemplate | DELETE /api/v1/email-templates/{id} | |
| DefaultApi | deleteEmailTemplateRenderError | DELETE /api/v1/email-templates/{id}/render-errors/{errorId} | |
| DefaultApi | deleteHashTag | DELETE /api/v1/hash-tags/{tag} | |
| DefaultApi | deleteModerator | DELETE /api/v1/moderators/{id} | |
| DefaultApi | deleteNotificationCount | DELETE /api/v1/notification-count/{id} | |
| DefaultApi | deletePage | DELETE /api/v1/pages/{id} | |
| DefaultApi | deletePendingWebhookEvent | DELETE /api/v1/pending-webhook-events/{id} | |
| DefaultApi | deleteQuestionConfig | DELETE /api/v1/question-configs/{id} | |
| DefaultApi | deleteQuestionResult | DELETE /api/v1/question-results/{id} | |
| DefaultApi | deleteSSOUser | DELETE /api/v1/sso-users/{id} | |
| DefaultApi | deleteSubscription | DELETE /api/v1/subscriptions/{id} | |
| DefaultApi | deleteTenant | DELETE /api/v1/tenants/{id} | |
| DefaultApi | deleteTenantPackage | DELETE /api/v1/tenant-packages/{id} | |
| DefaultApi | deleteTenantUser | DELETE /api/v1/tenant-users/{id} | |
| DefaultApi | deleteUserBadge | DELETE /api/v1/user-badges/{id} | |
| DefaultApi | deleteVote | DELETE /api/v1/votes/{id} | |
| DefaultApi | flagComment | POST /api/v1/comments/{id}/flag | |
| DefaultApi | getAuditLogs | GET /api/v1/audit-logs | |
| DefaultApi | getCachedNotificationCount | GET /api/v1/notification-count/{id} | |
| DefaultApi | getComment | GET /api/v1/comments/{id} | |
| DefaultApi | getComments | GET /api/v1/comments | |
| DefaultApi | getDomainConfig | GET /api/v1/domain-configs/{domain} | |
| DefaultApi | getDomainConfigs | GET /api/v1/domain-configs | |
| DefaultApi | getEmailTemplate | GET /api/v1/email-templates/{id} | |
| DefaultApi | getEmailTemplateDefinitions | GET /api/v1/email-templates/definitions | |
| DefaultApi | getEmailTemplateRenderErrors | GET /api/v1/email-templates/{id}/render-errors | |
| DefaultApi | getEmailTemplates | GET /api/v1/email-templates | |
| DefaultApi | getFeedPosts | GET /api/v1/feed-posts | req tenantId afterId |
| DefaultApi | getHashTags | GET /api/v1/hash-tags | |
| DefaultApi | getModerator | GET /api/v1/moderators/{id} | |
| DefaultApi | getModerators | GET /api/v1/moderators | |
| DefaultApi | getNotificationCount | GET /api/v1/notifications/count | |
| DefaultApi | getNotifications | GET /api/v1/notifications | |
| DefaultApi | getPageByURLId | GET /api/v1/pages/by-url-id | |
| DefaultApi | getPages | GET /api/v1/pages | |
| DefaultApi | getPendingWebhookEventCount | GET /api/v1/pending-webhook-events/count | |
| DefaultApi | getPendingWebhookEvents | GET /api/v1/pending-webhook-events | |
| DefaultApi | getQuestionConfig | GET /api/v1/question-configs/{id} | |
| DefaultApi | getQuestionConfigs | GET /api/v1/question-configs | |
| DefaultApi | getQuestionResult | GET /api/v1/question-results/{id} | |
| DefaultApi | getQuestionResults | GET /api/v1/question-results | |
| DefaultApi | getSSOUserByEmail | GET /api/v1/sso-users/by-email/{email} | |
| DefaultApi | getSSOUserById | GET /api/v1/sso-users/by-id/{id} | |
| DefaultApi | getSSOUsers | GET /api/v1/sso-users | |
| DefaultApi | getSubscriptions | GET /api/v1/subscriptions | |
| DefaultApi | getTenant | GET /api/v1/tenants/{id} | |
| DefaultApi | getTenantDailyUsages | GET /api/v1/tenant-daily-usage | |
| DefaultApi | getTenantPackage | GET /api/v1/tenant-packages/{id} | |
| DefaultApi | getTenantPackages | GET /api/v1/tenant-packages | |
| DefaultApi | getTenantUser | GET /api/v1/tenant-users/{id} | |
| DefaultApi | getTenantUsers | GET /api/v1/tenant-users | |
| DefaultApi | getTenants | GET /api/v1/tenants | |
| DefaultApi | getTicket | GET /api/v1/tickets/{id} | |
| DefaultApi | getTickets | GET /api/v1/tickets | |
| DefaultApi | getUser | GET /api/v1/users/{id} | |
| DefaultApi | getUserBadge | GET /api/v1/user-badges/{id} | |
| DefaultApi | getUserBadgeProgressById | GET /api/v1/user-badge-progress/{id} | |
| DefaultApi | getUserBadgeProgressByUserId | GET /api/v1/user-badge-progress/user/{userId} | |
| DefaultApi | getUserBadgeProgressList | GET /api/v1/user-badge-progress | |
| DefaultApi | getUserBadges | GET /api/v1/user-badges | |
| DefaultApi | getVotes | GET /api/v1/votes | |
| DefaultApi | getVotesForUser | GET /api/v1/votes/for-user | |
| DefaultApi | patchDomainConfig | PATCH /api/v1/domain-configs/{domainToUpdate} | |
| DefaultApi | patchHashTag | PATCH /api/v1/hash-tags/{tag} | |
| DefaultApi | patchPage | PATCH /api/v1/pages/{id} | |
| DefaultApi | patchSSOUser | PATCH /api/v1/sso-users/{id} | |
| DefaultApi | putDomainConfig | PUT /api/v1/domain-configs/{domainToUpdate} | |
| DefaultApi | putSSOUser | PUT /api/v1/sso-users/{id} | |
| DefaultApi | renderEmailTemplate | POST /api/v1/email-templates/render | |
| DefaultApi | replaceTenantPackage | PUT /api/v1/tenant-packages/{id} | |
| DefaultApi | replaceTenantUser | PUT /api/v1/tenant-users/{id} | |
| DefaultApi | saveComment | POST /api/v1/comments | |
| DefaultApi | saveCommentsBulk | POST /api/v1/comments/bulk | |
| DefaultApi | sendInvite | POST /api/v1/moderators/{id}/send-invite | |
| DefaultApi | sendLoginLink | POST /api/v1/tenant-users/{id}/send-login-link | |
| DefaultApi | unBlockUserFromComment | POST /api/v1/comments/{id}/un-block | |
| DefaultApi | unFlagComment | POST /api/v1/comments/{id}/un-flag | |
| DefaultApi | updateComment | PATCH /api/v1/comments/{id} | |
| DefaultApi | updateEmailTemplate | PATCH /api/v1/email-templates/{id} | |
| DefaultApi | updateFeedPost | PATCH /api/v1/feed-posts/{id} | |
| DefaultApi | updateModerator | PATCH /api/v1/moderators/{id} | |
| DefaultApi | updateNotification | PATCH /api/v1/notifications/{id} | |
| DefaultApi | updateQuestionConfig | PATCH /api/v1/question-configs/{id} | |
| DefaultApi | updateQuestionResult | PATCH /api/v1/question-results/{id} | |
| DefaultApi | updateSubscription | PATCH /api/v1/subscriptions/{id} | |
| DefaultApi | updateTenant | PATCH /api/v1/tenants/{id} | |
| DefaultApi | updateTenantPackage | PATCH /api/v1/tenant-packages/{id} | |
| DefaultApi | updateTenantUser | PATCH /api/v1/tenant-users/{id} | |
| DefaultApi | updateUserBadge | PUT /api/v1/user-badges/{id} | |
| ModerationApi | deleteModerationVote | DELETE /auth/my-account/moderate-comments/mod_api/vote/{commentId}/{voteId} | |
| ModerationApi | getApiComments | GET /auth/my-account/moderate-comments/mod_api/api/comments | |
| ModerationApi | getApiExportStatus | GET /auth/my-account/moderate-comments/mod_api/api/export/status | |
| ModerationApi | getApiIds | GET /auth/my-account/moderate-comments/mod_api/api/ids | |
| ModerationApi | getBanUsersFromComment | GET /auth/my-account/moderate-comments/mod_api/ban-users/from-comment/{commentId} | |
| ModerationApi | getCommentBanStatus | GET /auth/my-account/moderate-comments/mod_api/get-comment-ban-status/{commentId} | |
| ModerationApi | getCommentChildren | GET /auth/my-account/moderate-comments/mod_api/comment-children/{commentId} | |
| ModerationApi | getCount | GET /auth/my-account/moderate-comments/mod_api/count | |
| ModerationApi | getCounts | GET /auth/my-account/moderate-comments/banned-users/mod_api/counts | |
| ModerationApi | getLogs | GET /auth/my-account/moderate-comments/mod_api/logs/{commentId} | |
| ModerationApi | getManualBadges | GET /auth/my-account/moderate-comments/mod_api/get-manual-badges | |
| ModerationApi | getManualBadgesForUser | GET /auth/my-account/moderate-comments/mod_api/get-manual-badges-for-user | |
| ModerationApi | getModerationComment | GET /auth/my-account/moderate-comments/mod_api/comment/{commentId} | |
| ModerationApi | getModerationCommentText | GET /auth/my-account/moderate-comments/mod_api/get-comment-text/{commentId} | |
| ModerationApi | getPreBanSummary | GET /auth/my-account/moderate-comments/mod_api/pre-ban-summary/{commentId} | |
| ModerationApi | getSearchCommentsSummary | GET /auth/my-account/moderate-comments/mod_api/search/comments/summary | |
| ModerationApi | getSearchPages | GET /auth/my-account/moderate-comments/mod_api/search/pages | |
| ModerationApi | getSearchSites | GET /auth/my-account/moderate-comments/mod_api/search/sites | |
| ModerationApi | getSearchSuggest | GET /auth/my-account/moderate-comments/mod_api/search/suggest | |
| ModerationApi | getSearchUsers | GET /auth/my-account/moderate-comments/mod_api/search/users | |
| ModerationApi | getTrustFactor | GET /auth/my-account/moderate-comments/mod_api/get-trust-factor | |
| ModerationApi | getUserBanPreference | GET /auth/my-account/moderate-comments/mod_api/user-ban-preference | |
| ModerationApi | getUserInternalProfile | GET /auth/my-account/moderate-comments/mod_api/get-user-internal-profile | |
| ModerationApi | postAdjustCommentVotes | POST /auth/my-account/moderate-comments/mod_api/adjust-comment-votes/{commentId} | |
| ModerationApi | postApiExport | POST /auth/my-account/moderate-comments/mod_api/api/export | |
| ModerationApi | postBanUserFromComment | POST /auth/my-account/moderate-comments/mod_api/ban-user/from-comment/{commentId} | |
| ModerationApi | postBanUserUndo | POST /auth/my-account/moderate-comments/mod_api/ban-user/undo | |
| ModerationApi | postBulkPreBanSummary | POST /auth/my-account/moderate-comments/mod_api/bulk-pre-ban-summary | |
| ModerationApi | postCommentsByIds | POST /auth/my-account/moderate-comments/mod_api/comments-by-ids | |
| ModerationApi | postFlagComment | POST /auth/my-account/moderate-comments/mod_api/flag-comment/{commentId} | |
| ModerationApi | postRemoveComment | POST /auth/my-account/moderate-comments/mod_api/remove-comment/{commentId} | |
| ModerationApi | postRestoreDeletedComment | POST /auth/my-account/moderate-comments/mod_api/restore-deleted-comment/{commentId} | |
| ModerationApi | postSetCommentApprovalStatus | POST /auth/my-account/moderate-comments/mod_api/set-comment-approval-status/{commentId} | |
| ModerationApi | postSetCommentReviewStatus | POST /auth/my-account/moderate-comments/mod_api/set-comment-review-status/{commentId} | |
| ModerationApi | postSetCommentSpamStatus | POST /auth/my-account/moderate-comments/mod_api/set-comment-spam-status/{commentId} | |
| ModerationApi | postSetCommentText | POST /auth/my-account/moderate-comments/mod_api/set-comment-text/{commentId} | |
| ModerationApi | postUnFlagComment | POST /auth/my-account/moderate-comments/mod_api/un-flag-comment/{commentId} | |
| ModerationApi | postVote | POST /auth/my-account/moderate-comments/mod_api/vote/{commentId} | |
| ModerationApi | putAwardBadge | PUT /auth/my-account/moderate-comments/mod_api/award-badge | |
| ModerationApi | putCloseThread | PUT /auth/my-account/moderate-comments/mod_api/close-thread | |
| ModerationApi | putRemoveBadge | PUT /auth/my-account/moderate-comments/mod_api/remove-badge | |
| ModerationApi | putReopenThread | PUT /auth/my-account/moderate-comments/mod_api/reopen-thread | |
| ModerationApi | setTrustFactor | PUT /auth/my-account/moderate-comments/mod_api/set-trust-factor | |
| PublicApi | blockFromCommentPublic | POST /block-from-comment/{commentId} | |
| PublicApi | checkedCommentsForBlocked | GET /check-blocked-comments | |
| PublicApi | createCommentPublic | POST /comments/{tenantId} | |
| PublicApi | createFeedPostPublic | POST /feed-posts/{tenantId} | |
| PublicApi | createV1PageReact | POST /page-reacts/v1/likes/{tenantId} | |
| PublicApi | createV2PageReact | POST /page-reacts/v2/{tenantId} | |
| PublicApi | deleteCommentPublic | DELETE /comments/{tenantId}/{commentId} | |
| PublicApi | deleteCommentVote | DELETE /comments/{tenantId}/{commentId}/vote/{voteId} | |
| PublicApi | deleteFeedPostPublic | DELETE /feed-posts/{tenantId}/{postId} | |
| PublicApi | deleteV1PageReact | DELETE /page-reacts/v1/likes/{tenantId} | |
| PublicApi | deleteV2PageReact | DELETE /page-reacts/v2/{tenantId} | |
| PublicApi | flagCommentPublic | POST /flag-comment/{commentId} | |
| PublicApi | getCommentText | GET /comments/{tenantId}/{commentId}/text | |
| PublicApi | getCommentVoteUserNames | GET /comments/{tenantId}/{commentId}/votes | |
| PublicApi | getCommentsForUser | GET /comments-for-user | |
| PublicApi | getCommentsPublic | GET /comments/{tenantId} | req tenantId urlId |
| PublicApi | getEventLog | GET /event-log/{tenantId} | req tenantId urlId userIdWS |
| PublicApi | getFeedPostsPublic | GET /feed-posts/{tenantId} | req tenantId afterId |
| PublicApi | getFeedPostsStats | GET /feed-posts/{tenantId}/stats | |
| PublicApi | getGifLarge | GET /gifs/get-large/{tenantId} | |
| PublicApi | getGifsSearch | GET /gifs/search/{tenantId} | |
| PublicApi | getGifsTrending | GET /gifs/trending/{tenantId} | |
| PublicApi | getGlobalEventLog | GET /event-log/global/{tenantId} | req tenantId urlId userIdWS |
| PublicApi | getOfflineUsers | GET /pages/{tenantId}/users/offline | Comentadores antigos na página que NÃO estão online atualmente. Ordenados por displayName. Use isso após esgotar /users/online para renderizar uma seção "Members". Paginação por cursor no commenterName: o servidor percorre o índice parcial {tenantId, urlId, commenterName} a partir de afterName avançando via $gt, sem custo de $skip. |
| PublicApi | getOnlineUsers | GET /pages/{tenantId}/users/online | Visualizadores atualmente online de uma página: pessoas cuja sessão websocket está assinada à página neste momento. Retorna anonCount + totalCount (assinantes de toda a sala, incluindo visualizadores anônimos que não enumeramos). |
| PublicApi | getPagesPublic | GET /pages/{tenantId} | Lista as páginas de um tenant. Utilizado pelo cliente desktop FChat para preencher sua lista de salas. Requer que enableFChat esteja true na configuração customizada resolvida para cada página. Páginas que requerem SSO são filtradas com base no acesso ao grupo do usuário solicitante. |
| PublicApi | getTranslations | GET /translations/{namespace}/{component} | |
| PublicApi | getUserNotificationCount | GET /user-notifications/get-count | |
| PublicApi | getUserNotifications | GET /user-notifications | |
| PublicApi | getUserPresenceStatuses | GET /user-presence-status | |
| PublicApi | getUserReactsPublic | GET /feed-posts/{tenantId}/user-reacts | |
| PublicApi | getUsersInfo | GET /pages/{tenantId}/users/info | Bulk user info for a tenant. Given userIds, return display info from User / SSOUser. Used by the comment widget to enrich users that just appeared via a presence event. No page context: privacy is enforced uniformly (private profiles are masked). |
| PublicApi | getV1PageLikes | GET /page-reacts/v1/likes/{tenantId} | |
| PublicApi | getV2PageReactUsers | GET /page-reacts/v2/{tenantId}/list | |
| PublicApi | getV2PageReacts | GET /page-reacts/v2/{tenantId} | |
| PublicApi | lockComment | POST /comments/{tenantId}/{commentId}/lock | |
| PublicApi | logoutPublic | PUT /auth/logout | |
| PublicApi | pinComment | POST /comments/{tenantId}/{commentId}/pin | |
| PublicApi | reactFeedPostPublic | POST /feed-posts/{tenantId}/react/{postId} | |
| PublicApi | resetUserNotificationCount | POST /user-notifications/reset-count | |
| PublicApi | resetUserNotifications | POST /user-notifications/reset | |
| PublicApi | searchUsers | GET /user-search/{tenantId} | |
| PublicApi | setCommentText | POST /comments/{tenantId}/{commentId}/update-text | |
| PublicApi | unBlockCommentPublic | DELETE /block-from-comment/{commentId} | |
| PublicApi | unLockComment | POST /comments/{tenantId}/{commentId}/unlock | |
| PublicApi | unPinComment | POST /comments/{tenantId}/{commentId}/unpin | |
| PublicApi | updateFeedPostPublic | PUT /feed-posts/{tenantId}/{postId} | |
| PublicApi | updateUserNotificationCommentSubscriptionStatus | POST /user-notifications/{notificationId}/mark-opted/{optedInOrOut} | Enable or disable notifications for a specific comment. |
| PublicApi | updateUserNotificationPageSubscriptionStatus | POST /user-notifications/set-subscription-state/{subscribedOrUnsubscribed} | Enable or disable notifications for a page. When users are subscribed to a page, notifications are created for new root comments, and also |
| PublicApi | updateUserNotificationStatus | POST /user-notifications/{notificationId}/mark/{newStatus} | |
| PublicApi | uploadImage | POST /upload-image/{tenantId} | Upload and resize an image |
| PublicApi | voteComment | POST /comments/{tenantId}/{commentId}/vote |
Documentação dos Modelos
- APIAuditLog
- APIBanUserChangeLog
- APIBanUserChangedValues
- APIBannedUser
- APIBannedUserWithMultiMatchInfo
- APIComment
- APICommentBase
- APICommentBase_meta
- APICommentCommonBannedUser
- APICreateUserBadgeResponse
- APIDomainConfiguration
- APIEmptyResponse
- APIEmptySuccessResponse
- APIError
- APIGetCommentResponse
- APIGetCommentsResponse
- APIGetUserBadgeProgressListResponse
- APIGetUserBadgeProgressResponse
- APIGetUserBadgeResponse
- APIGetUserBadgesResponse
- APIModerateGetUserBanPreferencesResponse
- APIModerateUserBanPreferences
- APIPage
- APISSOUser
- APISaveCommentResponse
- APIStatus
- APITenant
- APITenantDailyUsage
- APITicket
- APITicketDetail
- APITicketFile
- APIUserSubscription
- AddDomainConfigParams
- AddDomainConfigResponse
- AddDomainConfigResponse_anyOf
- AddPageAPIResponse
- AddSSOUserAPIResponse
- AdjustCommentVotesParams
- AdjustVotesResponse
- AggregateQuestionResultsResponse
- AggregateResponse
- AggregateTimeBucket
- AggregationAPIError
- AggregationItem
- [
aggregate 
Agrega documentos agrupando‑os (se groupBy for fornecido) e aplicando várias operações. Diferentes operações (por exemplo, sum, countDistinct, avg, etc.) são suportadas.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| aggregationRequest | AggregationRequest | Não | |
| options | AggregateOptions | Não |
Resposta
Retorna: Option[AggregateResponse]
Exemplo

getAuditLogs 
Parameters
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Yes | |
| options | GetAuditLogsOptions | No |
Response
Retorna: Option[GetAuditLogsResponse]
Exemplo

logoutPublic 
Response
Returns: Option[APIEmptyResponse]
Example

blockFromCommentPublic 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| commentId | string | Sim | |
| publicBlockFromCommentParams | PublicBlockFromCommentParams | Não | |
| sso | string = "" | Não |
Resposta
Retorna: Option[BlockSuccess]
Exemplo

unBlockCommentPublic 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| publicBlockFromCommentParams | PublicBlockFromCommentParams | No | |
| sso | string = "" | No |
Resposta
Retorna: Option[UnblockSuccess]
Exemplo

checkedCommentsForBlocked 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| commentIds | string | Não | |
| sso | string = "" | Não |
Resposta
Retorna: Option[CheckBlockedCommentsResponse]
Exemplo

blockUserFromComment 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| blockFromCommentParams | BlockFromCommentParams | No | |
| options | BlockUserFromCommentOptions | No |
Resposta
Retorna: Option[BlockSuccess]
Exemplo

createCommentPublic 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Yes | |
| urlId | string | Yes | |
| broadcastId | string | No | |
| commentData | CommentData | No | |
| options | CreateCommentPublicOptions | No |
Resposta
Retorna: Option[SaveCommentsResponseWithPresence]
Exemplo

deleteComment 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| id | string | Não | |
| options | DeleteCommentOptions | Não |
Resposta
Retorna: Option[DeleteCommentResult]
Exemplo

deleteCommentPublic 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| commentId | string | Sim | |
| broadcastId | string | Não | |
| options | DeleteCommentPublicOptions | Não |
Resposta
Retorna: Option[PublicAPIDeleteCommentResponse]
Exemplo

deleteCommentVote 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| commentId | string | Sim | |
| voteId | string | Não | |
| urlId | string | Sim | |
| broadcastId | string | Não | |
| options | DeleteCommentVoteOptions | Não |
Resposta
Retorna: Option[VoteDeleteResponse]
Exemplo

flagComment 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| id | string | Não | |
| options | FlagCommentOptions | Não |
Resposta
Retorna: Option[FlagCommentResponse]
Exemplo

getComment 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| id | string | Não |
Resposta
Retorna: Option[APIGetCommentResponse]
Exemplo

getComments 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| options | GetCommentsOptions | Não |
Resposta
Retorna: Option[APIGetCommentsResponse]
Exemplo

getCommentsPublic 
req tenantId urlId
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| urlId | string | Sim | |
| options | GetCommentsPublicOptions | Não |
Resposta
Retorna: Option[GetCommentsResponseWithPresencePublicComment]
Exemplo

getCommentText 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| commentId | string | Sim | |
| options | GetCommentTextOptions | Não |
Resposta
Retorna: Option[PublicAPIGetCommentTextResponse]
Exemplo

getCommentVoteUserNames 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| commentId | string | Sim | |
| dir | int | Não | |
| sso | string = "" | Não |
Resposta
Retorna: Option[GetCommentVoteUserNamesSuccessResponse]
Exemplo

lockComment 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| commentId | string | Sim | |
| broadcastId | string | Não | |
| sso | string = "" | Não |
Resposta
Retorna: Option[APIEmptyResponse]
Exemplo

pinComment 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| commentId | string | Sim | |
| broadcastId | string | Não | |
| sso | string = "" | Não |
Resposta
Retorna: Option[ChangeCommentPinStatusResponse]
Exemplo

saveComment 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| createCommentParams | CreateCommentParams | Não | |
| options | SaveCommentOptions | Não |
Resposta
Retorna: Option[APISaveCommentResponse]
Exemplo

saveCommentsBulk 
Parâmetros
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| createCommentParams | seq[CreateCommentParams] | No | |
| options | SaveCommentsBulkOptions): (Option[seq[SaveCommentsBulkResponse]] | No | |
| id | string | No | |
| fromName | string | No |
Resposta
Retorna: Option[APIEmptyResponse]
Exemplo

setCommentText 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| commentTextUpdateRequest | CommentTextUpdateRequest | No | |
| options | SetCommentTextOptions | No |
Resposta
Retorna: Option[PublicAPISetCommentTextResponse]
Exemplo

unBlockUserFromComment 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| id | string | Não | |
| unBlockFromCommentParams | UnBlockFromCommentParams | Não | |
| options | UnBlockUserFromCommentOptions | Não |
Resposta
Retorna: Option[UnblockSuccess]
Exemplo

unFlagComment 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| id | string | Não | |
| options | UnFlagCommentOptions | Não |
Resposta
Retorna: Option[FlagCommentResponse]
Exemplo

unLockComment 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| commentId | string | Sim | |
| broadcastId | string | Não | |
| sso | string = "" | Não |
Resposta
Retorna: Option[APIEmptyResponse]
Exemplo

unPinComment 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| sso | string = "" | No |
Resposta
Retorna: Option[ChangeCommentPinStatusResponse]
Exemplo

updateComment 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| id | string | Não | |
| updatableCommentParams | UpdatableCommentParams | Não | |
| options | UpdateCommentOptions | Não |
Resposta
Retorna: Option[APIEmptyResponse]
Exemplo

voteComment 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| commentId | string | Sim | |
| urlId | string | Sim | |
| broadcastId | string | Não | |
| voteBodyParams | VoteBodyParams | Não | |
| options | VoteCommentOptions | Não |
Resposta
Retorna: Option[VoteResponse]
Exemplo

getCommentsForUser 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| options | GetCommentsForUserOptions | Não |
Resposta
Retorna: Option[GetCommentsForUserResponse]
Exemplo

addDomainConfig 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| addDomainConfigParams | AddDomainConfigParams | Não |
Resposta
Retorna: Option[AddDomainConfigResponse]
Exemplo

deleteDomainConfig 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| domain | string | Não |
Resposta
Retorna: Option[DeleteDomainConfigResponse]
Exemplo

getDomainConfig 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| domain | string | Não |
Resposta
Retorna: Option[GetDomainConfigResponse]
Exemplo

getDomainConfigs 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim |
Resposta
Retorna: Option[GetDomainConfigsResponse]
Exemplo

patchDomainConfig 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| domainToUpdate | string | Não | |
| patchDomainConfigParams | PatchDomainConfigParams | Não |
Resposta
Retorna: Option[PatchDomainConfigResponse]
Exemplo

putDomainConfig 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| domainToUpdate | string | Não | |
| updateDomainConfigParams | UpdateDomainConfigParams | Não |
Resposta
Retorna: Option[PutDomainConfigResponse]
Exemplo

createEmailTemplate 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| createEmailTemplateBody | CreateEmailTemplateBody | Não |
Resposta
Retorna: Option[CreateEmailTemplateResponse]
Exemplo

deleteEmailTemplate 
Parâmetros
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No |
Resposta
Retorna: Option[APIEmptyResponse]
Exemplo

deleteEmailTemplateRenderError 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| id | string | Não | |
| errorId | string | Não |
Resposta
Retorna: Option[APIEmptyResponse]
Exemplo

getEmailTemplate 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| id | string | Não |
Resposta
Retorna: Option[GetEmailTemplateResponse]
Exemplo

getEmailTemplateDefinitions 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim |
Resposta
Retorna: Option[GetEmailTemplateDefinitionsResponse]
Exemplo

getEmailTemplateRenderErrors 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| id | string | Não | |
| skip | float64 | Não |
Resposta
Retorna: Option[GetEmailTemplateRenderErrorsResponse]
Exemplo

getEmailTemplates 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| skip | float64 | Não |
Resposta
Retorna: Option[GetEmailTemplatesResponse]
Exemplo

renderEmailTemplate 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Yes | |
| renderEmailTemplateBody | RenderEmailTemplateBody | No | |
| locale | string = "" | No |
Resposta
Retorna: Option[RenderEmailTemplateResponse]
Exemplo

updateEmailTemplate 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| updateEmailTemplateBody | UpdateEmailTemplateBody | No |
Resposta
Retorna: Option[APIEmptyResponse]
Exemplo

getEventLog 
req tenantId urlId userIdWS
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Yes | |
| urlId | string | Yes | |
| userIdWS | string | No | |
| startTime | int64 | No | |
| endTime | int64 | No |
Resposta
Retorna: Option[GetEventLogResponse]
Exemplo

getGlobalEventLog 
req tenantId urlId userIdWS
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| urlId | string | Sim | |
| userIdWS | string | Não | |
| startTime | int64 | Não | |
| endTime | int64 | Não |
Resposta
Retorna: Option[GetEventLogResponse]
Exemplo

createFeedPost 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| createFeedPostParams | CreateFeedPostParams | Não | |
| options | CreateFeedPostOptions | Não |
Resposta
Retorna: Option[CreateFeedPostsResponse]
Exemplo

createFeedPostPublic 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| createFeedPostParams | CreateFeedPostParams | Não | |
| options | CreateFeedPostPublicOptions | Não |
Resposta
Retorna: Option[CreateFeedPostResponse]
Exemplo

deleteFeedPostPublic 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| postId | string | Não | |
| options | DeleteFeedPostPublicOptions | Não |
Resposta
Retorna: Option[DeleteFeedPostPublicResponse]
Exemplo

getFeedPosts 
req tenantId afterId
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| options | GetFeedPostsOptions | Não |
Resposta
Retorna: Option[GetFeedPostsResponse]
Exemplo

getFeedPostsPublic 
req
tenantId
afterId
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Sim | |
| options | GetFeedPostsPublicOptions | Não |
Resposta
Retorna: Option[PublicFeedPostsResponse]
Exemplo

getFeedPostsStats 
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| tenantId | string | Yes | |
| postIds | seq[string] | No | |
| sso | string = "" | No |
Resposta
Retorna: Option[FeedPostsStatsResponse]
Exemplo
