
Język 🇵🇱 Polski
Dokumentacja
Pierwsze kroki
Referencja API
Użycie
Agregacja
Dzienniki audytu
Uwierzytelnianie
Blokowanie z komentarza
Sprawdź zablokowane komentarze
Komentarze
Komentarze użytkownika
Konfiguracje domen
Szablony e-mail
Dziennik zdarzeń
Posty
Zgłaszanie komentarza
GIFy
Hashtagi
Moderacja
Moderatorzy
Liczba powiadomień
Powiadomienia
Reakcje strony
Strony
Oczekujące zdarzenia webhook
Konfiguracje pytań
Wyniki pytań
Agregacja wyników pytań
Użytkownicy SSO
Subskrypcje
Dzienne użycie najemcy
Pakiety najemcy
Użytkownicy najemcy
Najemcy
Zgłoszenia
Tłumaczenia
Przesyłanie obrazu
Postęp odznak użytkownika
Odznaki użytkownika
Powiadomienia użytkownika
Status obecności użytkownika
Wyszukiwanie użytkowników
Użytkownicy
Głosy
FastComments SDK dla Nim
To jest oficjalny SDK Nim dla FastComments.
Oficjalny SDK Nim dla API FastComments
Repozytorium
Instalacja 
Używanie Nimble
nimble install fastcomments
Budowanie ze źródła
nimble build
Zawartość Biblioteki
Ta biblioteka zawiera wygenerowanego klienta API oraz narzędzia SSO ułatwiające pracę z API.
Publiczne vs Zabezpieczone API
Dla klienta API istnieją trzy moduły API: api_default, api_public i api_moderation. api_default zawiera metody wymagające klucza API, a api_public zawiera wywołania API, które można wykonać bezpośrednio z przeglądarki/urządzenia mobilnego itp. bez uwierzytelnienia. Moduł api_moderation zawiera metody przeznaczone do panelu moderatora.
Moduł api_moderation oferuje rozbudowany zestaw szybkich i bieżących API moderacji. Każda metoda api_moderation przyjmuje parametr sso i może uwierzytelnić się za pomocą SSO lub ciasteczka sesyjnego FastComments.com.
Szybki start 
Using Authenticated APIs (DefaultAPI)
Important: Authenticated endpoints require your API key to be set as the x-api-key header.
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"
# Wykonaj uwierzytelnione wywołania API.
# Wymagane parametry (i ciało żądania) są pozycyjne; opcjonalne
# parametry są przekazywane za pomocą obiektu opcji operacji.
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"
Using Public APIs (PublicAPI)
Public endpoints don't require authentication:
import httpclient
import fastcomments
import fastcomments/apis/api_public
let client = newHttpClient()
# Wykonaj publiczne wywołania API.
# tenantId i urlId są wymagane (pozycyjne); wszystko inne jest opcjonalne.
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"
Using Moderation APIs (ModerationAPI)
Moderation endpoints power the moderator dashboard and are authenticated with an SSO token for the acting moderator:
import httpclient
import fastcomments
import fastcomments/apis/api_moderation
let client = newHttpClient()
# Lista komentarzy w panelu moderacji.
# Ta operacja nie ma wymaganych parametrów, więc wszystko jest opcjonalne.
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"
Common Issues
- 401 authentication error: Make sure you set the
x-api-keyheader on your HttpClient before making DefaultAPI requests:client.headers["x-api-key"] = "your-api-key" - Wrong API class: Use
api_defaultfor server-side authenticated requests,api_publicfor client-side/public requests, andapi_moderationfor moderator dashboard requests.
Making API Calls 
Wszystkie metody API w tym SDK zwracają krotki (Option[ResponseType], Response). Pierwszy element zawiera sparsowaną odpowiedź w przypadku sukcesu, a drugi element to surowa odpowiedź HTTP.
Wymagane parametry i ciało żądania są przekazywane pozycyjnie. Pozostałe opcjonalne parametry są zbierane w pojedynczy obiekt Api<Operation>Options, który jest ostatnim argumentem. Operacje bez parametrów opcjonalnych nie przyjmują obiektu opcji.
Przykład: Pobieranie komentarzy
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"
Notatki 
Identyfikatory Broadcast
Zauważysz, że w niektórych wywołaniach API należy przekazać broadcastId. Gdy otrzymasz zdarzenia, otrzymasz ten identyfikator z powrotem, dzięki czemu będziesz wiedzieć, aby zignorować zdarzenie, jeśli planujesz optymistycznie zastosować zmiany po stronie klienta
(co prawdopodobnie zechcesz zrobić, ponieważ zapewnia to najlepsze wrażenia). Przekaż tutaj UUID. Identyfikator powinien być na tyle unikalny, by nie wystąpić dwukrotnie w sesji przeglądarki.
SSO (Logowanie jednokrotne)
Przykłady SSO znajdują się poniżej.
Użycie SSO 
Proste 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
Bezpieczne 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
Dokumentacja FastComments 
Dokumentacja punktów końcowych API
All URIs are relative to https://fastcomments.com
| Klasa | Metoda | Żądanie HTTP | Opis |
|---|---|---|---|
| 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 | Agreguje dokumenty, grupując je (jeśli podano groupBy) i stosując wiele operacji. Obsługiwane są różne operacje (np. sum, countDistinct, avg itp.). |
| 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 | Poprzedni komentatorzy na stronie, którzy NIE są aktualnie online. Sortowani według displayName. Użyj tego po wyczerpaniu /users/online, aby wyświetlić sekcję "Members". Paginacja kursora po commenterName: serwer przegląda częściowy indeks {tenantId, urlId, commenterName} od afterName do przodu za pomocą $gt, bez kosztu $skip. |
| PublicApi | getOnlineUsers | GET /pages/{tenantId}/users/online | Obecnie online przeglądający stronę: osoby, których sesja websocket jest aktualnie subskrybowana do tej strony. Zwraca anonCount + totalCount (subskrybenci całego pokoju, w tym anonimowi przeglądający, których nie wymieniamy). |
| PublicApi | getPagesPublic | GET /pages/{tenantId} | Lista stron dla najemcy. Używana przez klienta desktopowego FChat do wypełnienia listy pokoi. Wymaga, aby enableFChat było ustawione na true w rozwiązywanej konfiguracji niestandardowej każdej strony. Strony wymagające SSO są filtrowane w oparciu o dostęp grupowy użytkownika żądającego. |
| 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} | Włącz lub wyłącz powiadomienia dla konkretnego komentarza. |
| PublicApi | updateUserNotificationPageSubscriptionStatus | POST /user-notifications/set-subscription-state/{subscribedOrUnsubscribed} | Włącz lub wyłącz powiadomienia dla strony. Gdy użytkownicy subskrybują stronę, powiadomienia są tworzone dla nowych komentarzy głównych, oraz także |
| PublicApi | updateUserNotificationStatus | POST /user-notifications/{notificationId}/mark/{newStatus} | |
| PublicApi | uploadImage | POST /upload-image/{tenantId} | Prześlij i zmień rozmiar obrazu |
| PublicApi | voteComment | POST /comments/{tenantId}/{commentId}/vote |
Dokumentacja modeli
- 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
- BulkCreateHashTagsBody_tags_inner
- BulkCreateHashTagsResponse
- BulkCreateHashTagsResponse_results_inner
- BulkPreBanParams
- BulkPreBanSummary
- ChangeCommentPinStatusResponse
- ChangeTicketStateBody
- ChangeTicketStateResponse
- CheckBlockedCommentsResponse
- CombineQuestionResultsWithCommentsResponse
- CommentData
- CommentHTMLRenderingMode
- CommentLogData
- CommentLogEntry
- CommentLogType
- [CommentQuestionResultsRenderingType](https://github.com/FastComments/fastcomments-nim/blob/master/docs/Models/
aggregate 
Agreguje dokumenty poprzez grupowanie ich (jeśli podano groupBy) i stosowanie wielu operacji. Obsługiwane są różne operacje (np. sum, countDistinct, avg, itp.).
Parametry
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| aggregationRequest | AggregationRequest | No | |
| options | AggregateOptions | No |
Odpowiedź
Zwraca: Option[AggregateResponse]
Przykład

getAuditLogs 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| options | GetAuditLogsOptions | Nie |
Odpowiedź
Zwraca: Option[GetAuditLogsResponse]
Przykład

logoutPublic 
Response
Zwraca: Option[APIEmptyResponse]
Przykład

blockFromCommentPublic 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| commentId | string | Tak | |
| publicBlockFromCommentParams | PublicBlockFromCommentParams | Nie | |
| sso | string = "" | Nie |
Odpowiedź
Zwraca: Option[BlockSuccess]
Przykład

unBlockCommentPublic 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| commentId | string | Tak | |
| publicBlockFromCommentParams | PublicBlockFromCommentParams | Nie | |
| sso | string = "" | Nie |
Odpowiedź
Zwraca: Option[UnblockSuccess]
Przykład

checkedCommentsForBlocked 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| commentIds | string | Nie | |
| sso | string = "" | Nie |
Odpowiedź
Zwraca: Option[CheckBlockedCommentsResponse]
Przykład

blockUserFromComment 
Parameters
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| blockFromCommentParams | BlockFromCommentParams | No | |
| options | BlockUserFromCommentOptions | No |
Response
Zwraca: Option[BlockSuccess]
Example

createCommentPublic 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| urlId | string | Yes | |
| broadcastId | string | No | |
| commentData | CommentData | No | |
| options | CreateCommentPublicOptions | No |
Odpowiedź
Zwraca: Option[SaveCommentsResponseWithPresence]
Przykład

deleteComment 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| options | DeleteCommentOptions | No |
Odpowiedź
Zwraca: Option[DeleteCommentResult]
Przykład

deleteCommentPublic 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| commentId | string | Tak | |
| broadcastId | string | Nie | |
| options | DeleteCommentPublicOptions | Nie |
Odpowiedź
Zwraca: Option[PublicAPIDeleteCommentResponse]
Przykład

deleteCommentVote 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| commentId | string | Tak | |
| voteId | string | Nie | |
| urlId | string | Tak | |
| broadcastId | string | Nie | |
| options | DeleteCommentVoteOptions | Nie |
Odpowiedź
Zwraca: Option[VoteDeleteResponse]
Przykład

flagComment 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| options | FlagCommentOptions | No |
Odpowiedź
Zwraca: Option[FlagCommentResponse]
Przykład

getComment 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No |
Odpowiedź
Zwraca: Option[APIGetCommentResponse]
Przykład

getComments 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| options | GetCommentsOptions | No |
Odpowiedź
Zwraca: Option[APIGetCommentsResponse]
Przykład

getCommentsPublic 
req tenantId urlId
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| urlId | string | Yes | |
| options | GetCommentsPublicOptions | No |
Odpowiedź
Zwraca: Option[GetCommentsResponseWithPresencePublicComment]
Przykład

getCommentText 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| commentId | string | Tak | |
| options | GetCommentTextOptions | Nie |
Odpowiedź
Zwraca: Option[PublicAPIGetCommentTextResponse]
Przykład

getCommentVoteUserNames 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| dir | int | No | |
| sso | string = "" | No |
Odpowiedź
Zwraca: Option[GetCommentVoteUserNamesSuccessResponse]
Przykład

lockComment 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| sso | string = "" | No |
Odpowiedź
Zwraca: Option[APIEmptyResponse]
Przykład

pinComment 
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Tak | |
| commentId | string | Tak | |
| broadcastId | string | Nie | |
| sso | string = "" | Nie |
Response
Zwraca: Option[ChangeCommentPinStatusResponse]
Example

saveComment 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| createCommentParams | CreateCommentParams | Nie | |
| options | SaveCommentOptions | Nie |
Odpowiedź
Zwraca: Option[APISaveCommentResponse]
Przykład

saveCommentsBulk 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| createCommentParams | seq[CreateCommentParams] | Nie | |
| options | SaveCommentsBulkOptions): (Option[seq[SaveCommentsBulkResponse]] | Nie | |
| id | string | Nie | |
| fromName | string | Nie |
Odpowiedź
Zwraca: Option[APIEmptyResponse]
Przykład

setCommentText 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| commentId | string | Tak | |
| broadcastId | string | Nie | |
| commentTextUpdateRequest | CommentTextUpdateRequest | Nie | |
| options | SetCommentTextOptions | Nie |
Odpowiedź
Zwraca: Option[PublicAPISetCommentTextResponse]
Przykład

unBlockUserFromComment 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| id | string | Nie | |
| unBlockFromCommentParams | UnBlockFromCommentParams | Nie | |
| options | UnBlockUserFromCommentOptions | Nie |
Odpowiedź
Zwraca: Option[UnblockSuccess]
Przykład

unFlagComment 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| id | string | Nie | |
| options | UnFlagCommentOptions | Nie |
Odpowiedź
Zwraca: Option[FlagCommentResponse]
Przykład

unLockComment 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| sso | string = "" | No |
Odpowiedź
Zwraca: Option[APIEmptyResponse]
Przykład

unPinComment 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| commentId | string | Tak | |
| broadcastId | string | Nie | |
| sso | string = "" | Nie |
Odpowiedź
Zwraca: Option[ChangeCommentPinStatusResponse]
Przykład

updateComment 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| id | string | Nie | |
| updatableCommentParams | UpdatableCommentParams | Nie | |
| options | UpdateCommentOptions | Nie |
Odpowiedź
Zwraca: Option[APIEmptyResponse]
Przykład

voteComment 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| commentId | string | Tak | |
| urlId | string | Tak | |
| broadcastId | string | Nie | |
| voteBodyParams | VoteBodyParams | Nie | |
| options | VoteCommentOptions | Nie |
Odpowiedź
Zwraca: Option[VoteResponse]
Przykład

getCommentsForUser 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| options | GetCommentsForUserOptions | Nie |
Odpowiedź
Zwraca: Option[GetCommentsForUserResponse]
Przykład

addDomainConfig 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| addDomainConfigParams | AddDomainConfigParams | Nie |
Odpowiedź
Zwraca: Option[AddDomainConfigResponse]
Przykład

deleteDomainConfig 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| domain | string | No |
Odpowiedź
Zwraca: Option[DeleteDomainConfigResponse]
Przykład

getDomainConfig 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| domain | string | No |
Odpowiedź
Zwraca: Option[GetDomainConfigResponse]
Przykład

getDomainConfigs 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak |
Odpowiedź
Zwraca: Option[GetDomainConfigsResponse]
Przykład

patchDomainConfig 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| domainToUpdate | string | Nie | |
| patchDomainConfigParams | PatchDomainConfigParams | Nie |
Odpowiedź
Zwraca: Option[PatchDomainConfigResponse]
Przykład

putDomainConfig 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| domainToUpdate | string | Nie | |
| updateDomainConfigParams | UpdateDomainConfigParams | Nie |
Odpowiedź
Zwraca: Option[PutDomainConfigResponse]
Przykład

createEmailTemplate 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| createEmailTemplateBody | CreateEmailTemplateBody | Nie |
Odpowiedź
Zwraca: Option[CreateEmailTemplateResponse]
Przykład

deleteEmailTemplate 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| id | string | Nie |
Odpowiedź
Zwraca: Option[APIEmptyResponse]
Przykład

deleteEmailTemplateRenderError 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| errorId | string | No |
Odpowiedź
Zwraca: Option[APIEmptyResponse]
Przykład

getEmailTemplate 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| id | string | Nie |
Odpowiedź
Zwraca: Option[GetEmailTemplateResponse]
Przykład

getEmailTemplateDefinitions 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak |
Odpowiedź
Zwraca: Option[GetEmailTemplateDefinitionsResponse]
Przykład

getEmailTemplateRenderErrors 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| id | string | Nie | |
| skip | float64 | Nie |
Odpowiedź
Zwraca: Option[GetEmailTemplateRenderErrorsResponse]
Przykład

getEmailTemplates 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| skip | float64 | Nie |
Odpowiedź
Zwraca: Option[GetEmailTemplatesResponse]
Przykład

renderEmailTemplate 
Parametry
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| renderEmailTemplateBody | RenderEmailTemplateBody | No | |
| locale | string = "" | No |
Odpowiedź
Zwraca: Option[RenderEmailTemplateResponse]
Przykład

updateEmailTemplate 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| updateEmailTemplateBody | UpdateEmailTemplateBody | No |
Odpowiedź
Zwraca: Option[APIEmptyResponse]
Przykład

getEventLog 
req tenantId urlId userIdWS
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| urlId | string | Tak | |
| userIdWS | string | Nie | |
| startTime | int64 | Nie | |
| endTime | int64 | Nie |
Odpowiedź
Zwraca: Option[GetEventLogResponse]
Przykład

getGlobalEventLog 
req tenantId urlId userIdWS
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| urlId | string | Tak | |
| userIdWS | string | Nie | |
| startTime | int64 | Nie | |
| endTime | int64 | Nie |
Odpowiedź
Zwraca: Option[GetEventLogResponse]
Przykład

createFeedPost 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| createFeedPostParams | CreateFeedPostParams | No | |
| options | CreateFeedPostOptions | No |
Odpowiedź
Zwraca: Option[CreateFeedPostsResponse]
Przykład

createFeedPostPublic 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| createFeedPostParams | CreateFeedPostParams | Nie | |
| options | CreateFeedPostPublicOptions | Nie |
Odpowiedź
Zwraca: Option[CreateFeedPostResponse]
Przykład

deleteFeedPostPublic 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| postId | string | No | |
| options | DeleteFeedPostPublicOptions | No |
Odpowiedź
Zwraca: Option[DeleteFeedPostPublicResponse]
Przykład

getFeedPosts 
req tenantId afterId
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| options | GetFeedPostsOptions | Nie |
Odpowiedź
Zwraca: Option[GetFeedPostsResponse]
Przykład

getFeedPostsPublic 
req tenantId afterId
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| options | GetFeedPostsPublicOptions | Nie |
Odpowiedź
Zwraca: Option[PublicFeedPostsResponse]
Przykład

getFeedPostsStats 
Parametry
| Nazwa | Typ | Wymagane | Opis |
|---|---|---|---|
| tenantId | string | Tak | |
| postIds | seq[string] | Nie | |
| sso | string = "" | Nie |
Odpowiedź
Zwraca: Option[FeedPostsStatsResponse]
Przykład
