
Sprache 🇩🇪 Deutsch
Dokumentation
Erste Schritte
API-Referenz
Verwendung
Aggregation
Audit-Protokolle
Authentifizierung
Vom Kommentar blockieren
Gesperrte Kommentare prüfen
Kommentare
Kommentare für Benutzer
Domain-Konfigurationen
E-Mail-Vorlagen
Ereignisprotokoll
Feed-Beiträge
Kommentar melden
GIFs
Hashtags
Moderation
Moderatoren
Benachrichtigungsanzahl
Benachrichtigungen
Seitenreaktionen
Seiten
Ausstehende Webhook-Ereignisse
Fragekonfigurationen
Frageergebnisse
Aggregation der Frageergebnisse
SSO-Benutzer
Abonnements
Tägliche Nutzung des Mandanten
Mandantenpakete
Mandantenbenutzer
Mandanten
Tickets
Übersetzungen
Bild hochladen
Fortschritt der Benutzerabzeichen
Benutzerabzeichen
Benutzerbenachrichtigungen
Benutzer-Anwesenheitsstatus
Benutzersuche
Benutzer
Abstimmungen
FastComments Nim SDK
Dies ist das offizielle Nim-SDK für FastComments.
Offizielles Nim-SDK für die FastComments-API
Repository
Installation 
Verwendung von Nimble
nimble install fastcomments
Aus dem Quellcode bauen
nimble build
Bibliotheksinhalt
Diese Bibliothek enthält den generierten API‑Client und die SSO‑Dienstprogramme, um die Arbeit mit der API zu erleichtern.
Öffentliche vs gesicherte APIs
Für den API‑Client gibt es drei API‑Module, api_default, api_public und api_moderation. Das api_default enthält Methoden, die Ihren API‑Schlüssel benötigen, und api_public enthält API‑Aufrufe, die direkt von einem Browser/Mobilgerät/etc. ohne Authentifizierung durchgeführt werden können. Das api_moderation‑Modul enthält Methoden für das Moderator‑Dashboard.
Das api_moderation‑Modul bietet eine umfangreiche Suite von Live‑ und schnellen Moderations‑APIs. Jede api_moderation‑Methode akzeptiert einen sso‑Parameter und kann über SSO oder ein FastComments.com‑Session‑Cookie authentifiziert werden.
Schnellstart 
Verwendung authentifizierter APIs (DefaultAPI)
Wichtig: Authentifizierte Endpunkte erfordern, dass Ihr API‑Schlüssel als Header x-api-key gesetzt wird.
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"
# Authentifizierte API‑Aufrufe durchführen.
# Erforderliche Parameter (und der Anfrage‑Body) sind positional; optionale
# Parameter werden über das Options‑Objekt der Operation übergeben.
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"
Verwendung öffentlicher APIs (PublicAPI)
Öffentliche Endpunkte erfordern keine Authentifizierung:
import httpclient
import fastcomments
import fastcomments/apis/api_public
let client = newHttpClient()
# Öffentliche API‑Aufrufe durchführen.
# tenantId und urlId sind erforderlich (positional); alles andere ist 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"
Verwendung von Moderations‑APIs (ModerationAPI)
Moderations‑Endpunkte versorgen das Moderator‑Dashboard und sind mit einem SSO‑Token für den handelnden Moderator authentifiziert:
import httpclient
import fastcomments
import fastcomments/apis/api_moderation
let client = newHttpClient()
# Kommentare im Moderations‑Dashboard auflisten.
# Diese Operation hat keine erforderlichen Parameter, daher ist alles 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"
Häufige Probleme
- 401 Authentifizierungsfehler: Stellen Sie sicher, dass Sie den Header
x-api-keyin Ihrem HttpClient setzen, bevor Sie DefaultAPI‑Anfragen stellen:client.headers["x-api-key"] = "your-api-key" - Falsche API‑Klasse: Verwenden Sie
api_defaultfür serverseitige authentifizierte Anfragen,api_publicfür clientseitige/öffentliche Anfragen undapi_moderationfür Anfragen an das Moderator‑Dashboard.
API-Aufrufe 
All API‑Methoden in diesem SDK geben Tupel von (Option[ResponseType], Response) zurück. Das erste Element enthält die geparste Antwort, wenn sie erfolgreich ist, und das zweite Element ist die rohe HTTP‑Antwort.
Erforderliche Parameter und der Request‑Body werden positionsbasiert übergeben. Die übrigen optionalen Parameter werden in einem einzelnen Api<Operation>Options‑Objekt gesammelt, das das letzte Argument ist. Vorgänge ohne optionale Parameter benötigen kein Options‑Objekt.
Beispiel: Abrufen von Kommentaren
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"
Hinweise 
Broadcast-IDs
Sie werden sehen, dass Sie in einigen API-Aufrufen ein broadcastId übergeben sollen. Wenn Sie Ereignisse erhalten, bekommen Sie diese ID zurück, sodass Sie das Ereignis ignorieren können, falls Sie Änderungen optimistisch auf dem Client anwenden möchten
(was Sie wahrscheinlich tun werden, da es die beste Nutzererfahrung bietet). Übergeben Sie hier eine UUID. Die ID sollte eindeutig genug sein, um in einer Browsersitzung nicht zweimal aufzutreten.
SSO (Single Sign-On)
Für SSO-Beispiele siehe unten.
SSO-Verwendung 
Einfaches 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
Sicheres 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
Dokumentation für FastComments 
Dokumentation für API-Endpunkte
Alle URIs sind relativ zu https://fastcomments.com
| Klasse | Methode | HTTP-Anfrage | Beschreibung |
|---|---|---|---|
| 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 | Aggregiert Dokumente, indem sie nach Gruppen zusammengefasst werden (wenn groupBy angegeben ist) und mehrere Operationen angewendet werden. Unterschiedliche Operationen (z. B. sum, countDistinct, avg usw.) werden unterstützt. |
| 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 | Past commenters on the page who are NOT currently online. Sorted by displayName. Use this after exhausting /users/online to render a "Members" section. Cursor pagination on commenterName: server walks the partial {tenantId, urlId, commenterName} index from afterName forward via $gt, no $skip cost. |
| PublicApi | getOnlineUsers | GET /pages/{tenantId}/users/online | Currently-online viewers of a page: people whose websocket session is subscribed to the page right now. Returns anonCount + totalCount (room-wide subscribers, including anon viewers we don't enumerate). |
| PublicApi | getPagesPublic | GET /pages/{tenantId} | List pages for a tenant. Used by the FChat desktop client to populate its room list. Requires enableFChat to be true on the resolved custom config for each page. Pages that require SSO are filtered against the requesting user's group access. |
| 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} | Aktivieren oder deaktivieren von Benachrichtigungen für einen bestimmten Kommentar. |
| PublicApi | updateUserNotificationPageSubscriptionStatus | POST /user-notifications/set-subscription-state/{subscribedOrUnsubscribed} | Aktivieren oder deaktivieren von Benachrichtigungen für eine Seite. Wenn Benutzer eine Seite abonniert haben, werden Benachrichtigungen für neue Hauptkommentare erstellt, und außerdem |
| PublicApi | updateUserNotificationStatus | POST /user-notifications/{notificationId}/mark/{newStatus} | |
| PublicApi | uploadImage | POST /upload-image/{tenantId} | Ein Bild hochladen und skalieren |
| PublicApi | voteComment | POST /comments/{tenantId}/{commentId}/vote |
Dokumentation für Modelle
- 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](https://github.com/FastComments/fastcomments-nim/blob
aggregate 
Aggregiert Dokumente, indem sie gruppiert werden (falls groupBy angegeben ist) und mehrere Operationen angewendet werden.
Verschiedene Operationen (z. B. sum, countDistinct, avg usw.) werden unterstützt.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| aggregationRequest | AggregationRequest | No | |
| options | AggregateOptions | No |
Response
Returns: Option[AggregateResponse]
Example

getAuditLogs 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| options | GetAuditLogsOptions | Nein |
Antwort
Rückgabe: Option[GetAuditLogsResponse]
Beispiel

logoutPublic 
Antwort
Rückgabe: Option[APIEmptyResponse]
Beispiel

blockFromCommentPublic 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| publicBlockFromCommentParams | PublicBlockFromCommentParams | No | |
| sso | string = "" | No |
Antwort
Rückgabe: Option[BlockSuccess]
Beispiel

unBlockCommentPublic 
Parameter
| Name | Type | Required | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| commentId | string | Ja | |
| publicBlockFromCommentParams | PublicBlockFromCommentParams | Nein | |
| sso | string = "" | Nein |
Antwort
Rückgabe: Option[UnblockSuccess]
Beispiel

checkedCommentsForBlocked 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Yes | |
| commentIds | string | No | |
| sso | string = "" | No |
Antwort
Rückgabe: Option[CheckBlockedCommentsResponse]
Beispiel

blockUserFromComment 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| blockFromCommentParams | BlockFromCommentParams | No | |
| options | BlockUserFromCommentOptions | No |
Antwort
Rückgabe: Option[BlockSuccess]
Beispiel

createCommentPublic 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Yes | |
| urlId | string | Yes | |
| broadcastId | string | No | |
| commentData | CommentData | No | |
| options | CreateCommentPublicOptions | No |
Antwort
Rückgabe: Option[SaveCommentsResponseWithPresence]
Beispiel

deleteComment 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| options | DeleteCommentOptions | No |
Antwort
Rückgabe: Option[DeleteCommentResult]
Beispiel

deleteCommentPublic 
Parameter
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| options | DeleteCommentPublicOptions | No |
Antwort
Returns: Option[PublicAPIDeleteCommentResponse]
Beispiel

deleteCommentVote 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| commentId | string | Ja | |
| voteId | string | Nein | |
| urlId | string | Ja | |
| broadcastId | string | Nein | |
| options | DeleteCommentVoteOptions | Nein |
Antwort
Rückgabe: Option[VoteDeleteResponse]
Beispiel

flagComment 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| id | string | Nein | |
| options | FlagCommentOptions | Nein |
Antwort
Rückgabe: Option[FlagCommentResponse]
Beispiel

getComment 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| id | string | Nein |
Antwort
Rückgabe: Option[APIGetCommentResponse]
Beispiel

getComments 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Yes | |
| options | GetCommentsOptions | No |
Antwort
Rückgabe: Option[APIGetCommentsResponse]
Beispiel

getCommentsPublic 
req tenantId urlId
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| urlId | string | Ja | |
| options | GetCommentsPublicOptions | Nein |
Antwort
Rückgabe: Option[GetCommentsResponseWithPresencePublicComment]
Beispiel

getCommentText 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| commentId | string | Ja | |
| options | GetCommentTextOptions | Nein |
Antwort
Rückgabe: Option[PublicAPIGetCommentTextResponse]
Beispiel

getCommentVoteUserNames 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| commentId | string | Ja | |
| dir | int | Nein | |
| sso | string = "" | Nein |
Antwort
Rückgabe: Option[GetCommentVoteUserNamesSuccessResponse]
Beispiel

lockComment 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| sso | string = "" | No |
Antwort
Returns: Option[APIEmptyResponse]
Beispiel

pinComment 
Parameter
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| sso | string = "" | No |
Antwort
Rückgabe: Option[ChangeCommentPinStatusResponse]
Beispiel

saveComment 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| createCommentParams | CreateCommentParams | Nein | |
| options | SaveCommentOptions | Nein |
Antwort
Rückgabe: Option[APISaveCommentResponse]
Beispiel

saveCommentsBulk 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| createCommentParams | seq[CreateCommentParams] | Nein | |
| options | SaveCommentsBulkOptions): (Option[seq[SaveCommentsBulkResponse]] | Nein | |
| id | string | Nein | |
| fromName | string | Nein |
Antwort
Rückgabe: Option[APIEmptyResponse]
Beispiel

setCommentText 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| commentTextUpdateRequest | CommentTextUpdateRequest | No | |
| options | SetCommentTextOptions | No |
Antwort
Rückgabe: Option[PublicAPISetCommentTextResponse]
Beispiel

unBlockUserFromComment 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| id | string | Nein | |
| unBlockFromCommentParams | UnBlockFromCommentParams | Nein | |
| options | UnBlockUserFromCommentOptions | Nein |
Antwort
Rückgabe: Option[UnblockSuccess]
Beispiel

unFlagComment 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| options | UnFlagCommentOptions | No |
Antwort
Rückgabe: Option[FlagCommentResponse]
Beispiel

unLockComment 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| sso | string = "" | No |
Antwort
Rückgabe: Option[APIEmptyResponse]
Beispiel

unPinComment 
Parameter
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| sso | string = "" | No |
Antwort
Rückgabe: Option[ChangeCommentPinStatusResponse]
Beispiel

updateComment 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| id | string | Nein | |
| updatableCommentParams | UpdatableCommentParams | Nein | |
| options | UpdateCommentOptions | Nein |
Antwort
Returns: Option[APIEmptyResponse]
Beispiel

voteComment 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| commentId | string | Ja | |
| urlId | string | Ja | |
| broadcastId | string | Nein | |
| voteBodyParams | VoteBodyParams | Nein | |
| options | VoteCommentOptions | Nein |
Antwort
Rückgabe: Option[VoteResponse]
Beispiel

getCommentsForUser 
Parameter
| Name | Type | Erforderlich | Beschreibung |
|---|---|---|---|
| options | GetCommentsForUserOptions | No |
Antwort
Rückgabe: Option[GetCommentsForUserResponse]
Beispiel

addDomainConfig 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| addDomainConfigParams | AddDomainConfigParams | Nein |
Antwort
Rückgabe: Option[AddDomainConfigResponse]
Beispiel

deleteDomainConfig 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| domain | string | Nein |
Antwort
Rückgabe: Option[DeleteDomainConfigResponse]
Beispiel

getDomainConfig 
Parameter
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| domain | string | No |
Antwort
Rückgabe: Option[GetDomainConfigResponse]
Beispiel

getDomainConfigs 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja |
Antwort
Rückgabe: Option[GetDomainConfigsResponse]
Beispiel

patchDomainConfig 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| domainToUpdate | string | Nein | |
| patchDomainConfigParams | PatchDomainConfigParams | Nein |
Antwort
Rückgabe: Option[PatchDomainConfigResponse]
Beispiel

putDomainConfig 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| domainToUpdate | string | Nein | |
| updateDomainConfigParams | UpdateDomainConfigParams | Nein |
Antwort
Rückgabe: Option[PutDomainConfigResponse]
Beispiel

createEmailTemplate 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| createEmailTemplateBody | CreateEmailTemplateBody | Nein |
Antwort
Rückgabe: Option[CreateEmailTemplateResponse]
Beispiel

deleteEmailTemplate 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| id | string | Nein |
Antwort
Rückgabe: Option[APIEmptyResponse]
Beispiel

deleteEmailTemplateRenderError 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| errorId | string | No |
Antwort
Rückgabe: Option[APIEmptyResponse]
Beispiel

getEmailTemplate 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| id | string | Nein |
Antwort
Rückgabe: Option[GetEmailTemplateResponse]
Beispiel

getEmailTemplateDefinitions 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja |
Antwort
Rückgabe: Option[GetEmailTemplateDefinitionsResponse]
Beispiel

getEmailTemplateRenderErrors 
Parameters
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| id | string | Nein | |
| skip | float64 | Nein |
Response
Rückgabe: Option[GetEmailTemplateRenderErrorsResponse]
Example

getEmailTemplates 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| skip | float64 | Nein |
Antwort
Rückgabe: Option[GetEmailTemplatesResponse]
Beispiel

renderEmailTemplate 
Parameter
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| renderEmailTemplateBody | RenderEmailTemplateBody | No | |
| locale | string = "" | No |
Antwort
Rückgabe: Option[RenderEmailTemplateResponse]
Beispiel

updateEmailTemplate 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| id | string | Nein | |
| updateEmailTemplateBody | UpdateEmailTemplateBody | Nein |
Antwort
Rückgabe: Option[APIEmptyResponse]
Beispiel

getEventLog 
req tenantId urlId userIdWS
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| urlId | string | Ja | |
| userIdWS | string | Nein | |
| startTime | int64 | Nein | |
| endTime | int64 | Nein |
Antwort
Rückgabe: Option[GetEventLogResponse]
Beispiel

getGlobalEventLog 
req tenantId urlId userIdWS
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| urlId | string | Ja | |
| userIdWS | string | Nein | |
| startTime | int64 | Nein | |
| endTime | int64 | Nein |
Antwort
Rückgabe: Option[GetEventLogResponse]
Beispiel

createFeedPost 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| createFeedPostParams | CreateFeedPostParams | Nein | |
| options | CreateFeedPostOptions | Nein |
Antwort
Rückgabe: Option[CreateFeedPostsResponse]
Beispiel

createFeedPostPublic 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| createFeedPostParams | CreateFeedPostParams | Nein | |
| options | CreateFeedPostPublicOptions | Nein |
Antwort
Gibt zurück: Option[CreateFeedPostResponse]
Beispiel

deleteFeedPostPublic 
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| postId | string | Nein | |
| options | DeleteFeedPostPublicOptions | Nein |
Antwort
Rückgabe: Option[DeleteFeedPostPublicResponse]
Beispiel

getFeedPosts 
req tenantId afterId
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| options | GetFeedPostsOptions | Nein |
Antwort
Rückgabe: Option[GetFeedPostsResponse]
Beispiel

getFeedPostsPublic 
req tenantId afterId
Parameter
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| tenantId | string | Ja | |
| options | GetFeedPostsPublicOptions | Nein |
Antwort
Rückgabe: Option[PublicFeedPostsResponse]
Beispiel

getFeedPostsStats 
Parameter
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| postIds | seq[string] | No | |
| sso | string = "" | No |
Antwort
Rückgabe: Option[FeedPostsStatsResponse]
Beispiel
