
Мова 🇺🇦 Українська
Документація
Початок роботи
Довідник API
Використання
Агрегація
Журнали аудиту
Аутентифікація
Блокування за коментарем
Перевірити заблоковані коментарі
Коментарі
Коментарі для користувача
Конфігурації домену
Шаблони електронної пошти
Журнал подій
Публікації стрічки
Позначення коментаря
Гіфки
Хештеги
Модерація
Модератори
Кількість сповіщень
Сповіщення
Реакції сторінки
Сторінки
Очікувані події вебхуків
Налаштування запитань
Результати запитань
Агрегація результатів запитань
Користувачі SSO
Підписки
Щоденне використання орендаря
Пакети орендаря
Користувачі орендаря
Орендарі
Тікети
Переклади
Завантажити зображення
Прогрес значків користувача
Значки користувача
Сповіщення користувача
Статуси присутності користувача
Пошук користувачів
Користувачі
Голоси
FastComments Nim SDK
Це офіційний SDK на Nim для FastComments.
Офіційний Nim SDK для API FastComments
Репозиторій
Встановлення 
Using Nimble
nimble install fastcomments
Building from Source
nimble build
Library Contents
This library contains the generated API client and the SSO utilities to make working with the API easier.
Public vs Secured APIs
For the API client, there are three API modules, api_default, api_public, and api_moderation. The api_default contains methods that require your API key, and api_public contains api calls
that can be made directly from a browser/mobile device/etc without authentication. The api_moderation module contains methods for the moderator dashboard.
The api_moderation module provides an extensive suite of live and fast moderation APIs. Every api_moderation method accepts an sso parameter and can authenticate via SSO or a FastComments.com session cookie.
Швидкий старт 
Використання автентифікованих API (DefaultAPI)
Important: Автентифіковані кінцеві точки потребують, щоб ваш API ключ був встановлений у заголовок 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"
# Make authenticated API calls.
# Required parameters (and the request body) are positional; optional
# parameters are passed via the operation's options object.
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"
Використання публічних API (PublicAPI)
Публічні кінцеві точки не вимагають автентифікації:
import httpclient
import fastcomments
import fastcomments/apis/api_public
let client = newHttpClient()
# Make public API calls.
# tenantId and urlId are required (positional); everything else is optional.
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"
Використання модераційних API (ModerationAPI)
Модераційні кінцеві точки живлять панель модератора і автентифіковані за допомогою SSO токена для діючого модератора:
import httpclient
import fastcomments
import fastcomments/apis/api_moderation
let client = newHttpClient()
# List comments in the moderation dashboard.
# This operation has no required parameters, so everything is optional.
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"
Поширені проблеми
- 401 authentication error: Переконайтеся, що ви встановили заголовок
x-api-keyу вашому HttpClient перед виконанням запитів DefaultAPI:client.headers["x-api-key"] = "your-api-key" - Wrong API class: Використовуйте
api_defaultдля серверних автентифікованих запитів,api_publicдля клієнтських/публічних запитів, іapi_moderationдля запитів панелі модератора.
Виклики API 
Усі методи API в цьому SDK повертають кортежі (Option[ResponseType], Response). Перший елемент містить розпарсений відповідь, якщо успішно, а другий елемент — це необроблена HTTP‑відповідь.
Обов’язкові параметри та тіло запиту передаються позиційно. Решта необов’язкових параметрів збираються в один об’єкт Api<Operation>Options, який є останнім аргументом. Операції без необов’язкових параметрів не беруть об’єкт параметрів.
Приклад: отримання коментарів
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"
Примітки 
Ідентифікатори трансляцій
Ви побачите, що потрібно передавати broadcastId у деяких викликах API. Коли ви отримуєте події, ви отримаєте назад цей ідентифікатор, тож знатимете, що можна ігнорувати подію, якщо плануєте оптимістично застосувати зміни на клієнті (що, ймовірно, буде бажаним, оскільки забезпечує найкращий досвід). Передайте тут UUID. Ідентифікатор має бути достатньо унікальним, щоб не повторюватися двічі в одній сесії браузера.
SSO (Єдиний вхід)
Для прикладів SSO дивіться нижче.
Використання SSO 
Простий SSO
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
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
Документація для fastcomments 
Документація для API-ендоинтів
All URIs are relative to https://fastcomments.com → Усі URI є відносними до https://fastcomments.com
| Class | Method | HTTP request | Description |
|---|---|---|---|
| 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 | Скуповує документи шляхом групування їх (якщо вказано groupBy) та застосування декількох операцій. Підтримуються різні операції (наприклад, sum, countDistinct, avg тощо). |
| 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 | Користувачі, які раніше коментували сторінку, але зараз НЕ в онлайн. Сортовано за displayName. Використовуйте це після того, як вичерпані дані /users/online, щоб відобразити розділ “Учасники”. Пагінація за курсором по commenterName: сервер проходить частковий індекс {tenantId, urlId, commenterName} від afterName вперед через $gt, без витрат на $skip. |
| PublicApi | getOnlineUsers | GET /pages/{tenantId}/users/online | Користувачі, які зараз онлайн і переглядають сторінку: люди, чия WebSocket‑сесія підписана на сторінку в даний момент. Повертає anonCount + totalCount (всі підписники кімнати, включаючи анонімних глядачів, які не перераховуються). |
| PublicApi | getPagesPublic | GET /pages/{tenantId} | Список сторінок для орендаря. Використовується десктоп‑клієнтом FChat для заповнення списку кімнат. Потрібно, щоб enableFChat був встановлений у true у розв’язаній кастомній конфігурації для кожної сторінки. Сторінки, що потребують SSO, фільтруються відповідно до групового доступу запитуючого користувача. |
| 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 |
Документація моделей
- 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
- AggregationOpType
- AggregationOperation
- AggregationRequest
- AggregationRequest_sort
- AggregationResponse
- AggregationResponse_stats
- AggregationValue
- AwardUserBadgeResponse
- BanUserFromCommentResult
- BanUserUndoParams
- BannedUserMatch
- BannedUserMatchType
- BannedUserMatch_matchedOnValue
- BillingInfo
- BlockFromCommentParams
- BlockSuccess
- BuildModerationFilterParams
- BuildModerationFilterResponse
- BulkAggregateQuestionItem
- BulkAggregateQuestionResultsRequest
- BulkAggregateQuestionResultsResponse
- [BulkCreateHashTagsBody](https://github.com/FastComments/fast
aggregate 
Агрегує документи, групуючи їх (якщо зазначено groupBy) і застосовуючи кілька операцій.
Різні операції (наприклад, sum, countDistinct, avg тощо) підтримуються.
Параметри
| Назва | Тип | Обов’язково | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| aggregationRequest | AggregationRequest | No | |
| options | AggregateOptions | No |
Відповідь
Returns: Option[AggregateResponse]
Приклад

getAuditLogs 
Параметри
| Назва | Тип | Обов'язково | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| options | GetAuditLogsOptions | Ні |
Відповідь
Повертає: Option[GetAuditLogsResponse]
Приклад

logoutPublic 
Відповідь
Повертає: Option[APIEmptyResponse]
Приклад

blockFromCommentPublic 
Параметри
| Назва | Тип | Обов’язково | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| commentId | string | Так | |
| publicBlockFromCommentParams | PublicBlockFromCommentParams | Ні | |
| sso | string = "" | Ні |
Відповідь
Повертає: Option[BlockSuccess]
Приклад

unBlockCommentPublic 
Параметри
| Ім'я | Тип | Обов'язково | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| publicBlockFromCommentParams | PublicBlockFromCommentParams | No | |
| sso | string = "" | No |
Відповідь
Повертає: Option[UnblockSuccess]
Приклад

checkedCommentsForBlocked 
Параметри
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| commentIds | string | No | |
| sso | string = "" | No |
Відповідь
Повертає: Option[CheckBlockedCommentsResponse]
Приклад

blockUserFromComment 
Параметри
| Назва | Тип | Обов'язково | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| blockFromCommentParams | BlockFromCommentParams | No | |
| options | BlockUserFromCommentOptions | No |
Відповідь
Повертає: Option[BlockSuccess]
Приклад

createCommentPublic 
Параметри
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| urlId | string | Yes | |
| broadcastId | string | No | |
| commentData | CommentData | No | |
| options | CreateCommentPublicOptions | No |
Відповідь
Повертає: Option[SaveCommentsResponseWithPresence]
Приклад

deleteComment 
Параметри
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| options | DeleteCommentOptions | No |
Відповідь
Повертає: Option[DeleteCommentResult]
Приклад

deleteCommentPublic 
Параметри
| Назва | Тип | Обов'язковий | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| options | DeleteCommentPublicOptions | No |
Відповідь
Повертає: Option[PublicAPIDeleteCommentResponse]
Приклад

deleteCommentVote 
Параметри
| Назва | Тип | Обов’язковий | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| commentId | string | Так | |
| voteId | string | Ні | |
| urlId | string | Так | |
| broadcastId | string | Ні | |
| options | DeleteCommentVoteOptions | Ні |
Відповідь
Повертає: Option[VoteDeleteResponse]
Приклад

flagComment 
Параметри
| Назва | Тип | Обов’язково | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| options | FlagCommentOptions | No |
Відповідь
Повертає: Option[FlagCommentResponse]
Приклад

getComment 
Параметри
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No |
Відповідь
Повертає: Option[APIGetCommentResponse]
Приклад

getComments 
Параметри
| Назва | Тип | Обов’язковий | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| options | GetCommentsOptions | No |
Відповідь
Повертає: Option[APIGetCommentsResponse]
Приклад

getCommentsPublic 
req tenantId urlId
Параметри
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| urlId | string | Yes | |
| options | GetCommentsPublicOptions | No |
Відповідь
Повертає: Option[GetCommentsResponseWithPresencePublicComment]
Приклад

getCommentText 
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| options | GetCommentTextOptions | No |
Response
Returns: Option[PublicAPIGetCommentTextResponse]
Example

getCommentVoteUserNames 
Параметри
| Назва | Тип | Обов’язково | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| commentId | string | Так | |
| dir | int | Ні | |
| sso | string = "" | Ні |
Відповідь
Повертає: Option[GetCommentVoteUserNamesSuccessResponse]
Приклад

lockComment 
Параметри
| Назва | Тип | Обов'язковий | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| commentId | string | Так | |
| broadcastId | string | Ні | |
| sso | string = "" | Ні |
Відповідь
Повертає: Option[APIEmptyResponse]
Приклад

pinComment 
Параметри
| Назва | Тип | Обов’язковий | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| commentId | string | Так | |
| broadcastId | string | Ні | |
| sso | string = "" | Ні |
Відповідь
Повертає: Option[ChangeCommentPinStatusResponse]
Приклад

saveComment 
Параметри
| Назва | Тип | Обов'язково | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| createCommentParams | CreateCommentParams | Ні | |
| options | SaveCommentOptions | Ні |
Відповідь
Повертає: Option[APISaveCommentResponse]
Приклад

saveCommentsBulk 
Параметри
| Назва | Тип | Обов'язковий | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| createCommentParams | seq[CreateCommentParams] | Ні | |
| options | SaveCommentsBulkOptions): (Option[seq[SaveCommentsBulkResponse]] | Ні | |
| id | string | Ні | |
| fromName | string | Ні |
Відповідь
Повертає: Option[APIEmptyResponse]
Приклад

setCommentText 
Параметри
| Назва | Тип | Обов'язковий | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| commentTextUpdateRequest | CommentTextUpdateRequest | No | |
| options | SetCommentTextOptions | No |
Відповідь
Повертає: Option[PublicAPISetCommentTextResponse]
Приклад

unBlockUserFromComment 
Параметри
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| unBlockFromCommentParams | UnBlockFromCommentParams | No | |
| options | UnBlockUserFromCommentOptions | No |
Відповідь
Повертає: Option[UnblockSuccess]
Приклад

unFlagComment 
Параметри
| Ім'я | Тип | Обов'язково | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| id | string | Ні | |
| options | UnFlagCommentOptions | Ні |
Відповідь
Повертає: Option[FlagCommentResponse]
Приклад

unLockComment 
Параметри
| Назва | Тип | Обов'язковий | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| sso | string = "" | No |
Відповідь
Returns: Option[APIEmptyResponse]
Приклад

unPinComment 
Параметри
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Так | |
| commentId | string | Так | |
| broadcastId | string | Ні | |
| sso | string = "" | Ні |
Відповідь
Повертає: Option[ChangeCommentPinStatusResponse]
Приклад

updateComment 
Параметри
| Назва | Тип | Обов’язковий | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| id | string | Ні | |
| updatableCommentParams | UpdatableCommentParams | Ні | |
| options | UpdateCommentOptions | Ні |
Відповідь
Повертає: Option[APIEmptyResponse]
Приклад

voteComment 
Параметри
| Назва | Тип | Обов'язково | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| urlId | string | Yes | |
| broadcastId | string | No | |
| voteBodyParams | VoteBodyParams | No | |
| options | VoteCommentOptions | No |
Відповідь
Повертає: Option[VoteResponse]
Приклад

getCommentsForUser 
Параметри
| Назва | Тип | Обов’язковий | Опис |
|---|---|---|---|
| options | GetCommentsForUserOptions | No |
Відповідь
Повертає: Option[GetCommentsForUserResponse]
Приклад

addDomainConfig 
Параметри
| Назва | Тип | Обов’язково | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| addDomainConfigParams | AddDomainConfigParams | No |
Відповідь
Повертає: Option[AddDomainConfigResponse]
Приклад

deleteDomainConfig 
Параметри
| Ім'я | Тип | Обов'язково | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| domain | string | No |
Відповідь
Повертає: Option[DeleteDomainConfigResponse]
Приклад

getDomainConfig 
Параметри
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Так | |
| domain | string | Ні |
Відповідь
Повертає: Option[GetDomainConfigResponse]
Приклад

getDomainConfigs 
Параметри
| Назва | Тип | Обов’язковий | Опис |
|---|---|---|---|
| tenantId | string | Yes |
Відповідь
Повертає: Option[GetDomainConfigsResponse]
Приклад

patchDomainConfig 
Parameters
| Назва | Тип | Обов’язковий | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| domainToUpdate | string | Ні | |
| patchDomainConfigParams | PatchDomainConfigParams | Ні |
Response
Повертає: Option[PatchDomainConfigResponse]
Example

putDomainConfig 
Параметри
| Назва | Тип | Обов’язковий | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| domainToUpdate | string | No | |
| updateDomainConfigParams | UpdateDomainConfigParams | No |
Відповідь
Повертає: Option[PutDomainConfigResponse]
Приклад

createEmailTemplate 
Параметри
| Назва | Тип | Обов’язковий | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| createEmailTemplateBody | CreateEmailTemplateBody | No |
Відповідь
Повертає: Option[CreateEmailTemplateResponse]
Приклад

deleteEmailTemplate 
Параметри
| Назва | Тип | Обов'язковий | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| id | string | Ні |
Відповідь
Повертає: Option[APIEmptyResponse]
Приклад

deleteEmailTemplateRenderError 
Параметри
| Назва | Тип | Обов’язково | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| id | string | Ні | |
| errorId | string | Ні |
Відповідь
Повертає: Option[APIEmptyResponse]
Приклад

getEmailTemplate 
Параметри
| Назва | Тип | Обов’язково | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| id | string | Ні |
Відповідь
Повертає: Option[GetEmailTemplateResponse]
Приклад

getEmailTemplateDefinitions 
Параметри
| Назва | Тип | Обов’язковий | Опис |
|---|---|---|---|
| tenantId | string | Yes |
Відповідь
Повертає: Option[GetEmailTemplateDefinitionsResponse]
Приклад

getEmailTemplateRenderErrors 
Параметри
| Назва | Тип | Обов'язковий | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| skip | float64 | No |
Відповідь
Повертає: Option[GetEmailTemplateRenderErrorsResponse]
Приклад

getEmailTemplates 
Параметри
| Назва | Тип | Обов’язковий | Опис |
|---|---|---|---|
| tenantId | string | Yes | |
| skip | float64 | No |
Відповідь
Returns: Option[GetEmailTemplatesResponse]
Приклад

renderEmailTemplate 
Параметри
| Назва | Тип | Обов’язковий | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| renderEmailTemplateBody | RenderEmailTemplateBody | Ні | |
| locale | string = "" | Ні |
Відповідь
Повертає: Option[RenderEmailTemplateResponse]
Приклад

updateEmailTemplate 
Параметри
| Назва | Тип | Обов’язковий | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| id | string | Ні | |
| updateEmailTemplateBody | UpdateEmailTemplateBody | Ні |
Відповідь
Повертає: Option[APIEmptyResponse]
Приклад

getEventLog 
req tenantId urlId userIdWS
Параметри
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| urlId | string | Yes | |
| userIdWS | string | No | |
| startTime | int64 | No | |
| endTime | int64 | No |
Відповідь
Повертає: Option[GetEventLogResponse]
Приклад

getGlobalEventLog 
req tenantId urlId userIdWS
Параметри
| Назва | Тип | Обов’язковий | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| urlId | string | Так | |
| userIdWS | string | Ні | |
| startTime | int64 | Ні | |
| endTime | int64 | Ні |
Відповідь
Повертає: Option[GetEventLogResponse]
Приклад

createFeedPost 
Параметри
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| createFeedPostParams | CreateFeedPostParams | No | |
| options | CreateFeedPostOptions | No |
Відповідь
Returns: Option[CreateFeedPostsResponse]
Приклад

createFeedPostPublic 
Параметри
| Назва | Тип | Обов'язково | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| createFeedPostParams | CreateFeedPostParams | Ні | |
| options | CreateFeedPostPublicOptions | Ні |
Відповідь
Повертає: Option[CreateFeedPostResponse]
Приклад

deleteFeedPostPublic 
Параметри
| Назва | Тип | Обов’язково | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| postId | string | Ні | |
| options | DeleteFeedPostPublicOptions | Ні |
Відповідь
Повертає: Option[DeleteFeedPostPublicResponse]
Приклад

getFeedPosts 
req tenantId afterId
Параметри
| Назва | Тип | Обов'язково | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| options | GetFeedPostsOptions | Ні |
Відповідь
Повертає: Option[GetFeedPostsResponse]
Приклад

getFeedPostsPublic 
req tenantId afterId
Параметри
| Назва | Тип | Обов'язковий | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| options | GetFeedPostsPublicOptions | Ні |
Відповідь
Повертає: Option[PublicFeedPostsResponse]
Приклад

getFeedPostsStats 
Параметри
| Назва | Тип | Обов’язково | Опис |
|---|---|---|---|
| tenantId | string | Так | |
| postIds | seq[string] | Ні | |
| sso | string = "" | Ні |
Відповідь
Повертає: Option[FeedPostsStatsResponse]
Приклад
