
Jezik 🇸🇮 Slovenščina
Dokumentacija
Začetek
API referenca
Uporaba
Agregiranje
Revizijski zapisi
Avtentikacija
Blokiranje pri komentiranju
Preveri blokirane komentarje
Komentarji
Komentarji za uporabnika
Konfiguracije domene
E-poštne predloge
Dnevnik dogodkov
Objave
Prijavi komentar
GIFi
Hashtagi
Moderacija
Moderatorji
Število obvestil
Obvestila
Reakcije strani
Strani
Čakajoči Webhook dogodki
Konfiguracije vprašanj
Rezultati vprašanj
Agregacija rezultatov vprašanj
SSO uporabniki
Naročnine
Dnevna uporaba najemnika
Paketi najemnika
Uporabniki najemnika
Najemniki
Vstopnice
Prevodi
Naloži sliko
Napredek značke uporabnika
Uporabniške značke
Uporabniška obvestila
Status prisotnosti uporabnika
Iskanje uporabnikov
Uporabniki
Glasovi
FastComments Nim SDK
To je uradni Nim SDK za FastComments.
Uradni Nim SDK za FastComments API
Repozitorij
Namestitev 
Using Nimble
nimble install fastcomments
Building from Source
nimble build
Library Contents
Ta knjižnica vsebuje ustvarjen API odjemalec in SSO pripomočke, ki olajšajo delo z API-jem.
Public vs Secured APIs
Za API odjemalca obstajajo trije API moduli, api_default, api_public in api_moderation. api_default vsebuje metode, ki zahtevajo vaš API ključ, api_public vsebuje klice API, ki jih je mogoče izvesti neposredno iz brskalnika/mobilne naprave/ipd. brez avtentikacije. Modul api_moderation vsebuje metode za nadzorno ploščo moderatorjev.
Modul api_moderation ponuja obsežen nabor API-jev za živo in hitro moderiranje. Vsaka metoda api_moderation sprejme parameter sso in lahko overi prek SSO ali piškotka seje FastComments.com.
Hiter začetek 
Uporaba avtenticiranih API-jev (DefaultAPI)
Pomembno: Avtenticirani končni naslovi zahtevajo, da je vaš API ključ nastavljen v glavi 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"
# Naredi avtenticirane klice API-ja.
# Zahtevani parametri (in telo zahteve) so položajni; neobvezni
# parametri se posredujejo prek objekt options operacije.
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"
Uporaba javnih API-jev (PublicAPI)
Javni končni naslovi ne zahtevajo avtentikacije:
import httpclient
import fastcomments
import fastcomments/apis/api_public
let client = newHttpClient()
# Naredi javne klice API-ja.
# tenantId in urlId sta obvezna (položajna); vse ostalo je neobvezno.
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"
Uporaba moderacijskih API-jev (ModerationAPI)
Moderacijski končni naslovi poganjajo nadzorno ploščo moderatorja in so avtenticirani z SSO žetonom za delujočega moderatorja:
import httpclient
import fastcomments
import fastcomments/apis/api_moderation
let client = newHttpClient()
# Izpiši komentarje v moderacijski nadzorni plošči.
# Ta operacija nima zahtevanih parametrov, zato je vse neobvezno.
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"
Pogoste težave
- Napaka 401 pri avtentikaciji: Prepričajte se, da ste nastavili glavo
x-api-keyna vašem HttpClient-u pred pošiljanjem zahtevanj DefaultAPI:client.headers["x-api-key"] = "your-api-key" - Napačen API razred: Uporabite
api_defaultza strežniške avtenticirane zahteve,api_publicza odjemalske/javne zahteve inapi_moderationza zahteve moderacijske nadzorne plošče.
Klicanje API-ja 
All API metode v tem SDK-ju vrnejo nizek (Option[ResponseType], Response). Prvi element vsebuje razčlenjen odgovor, če je uspešen, drugi element pa je surov HTTP odziv.
Obvezni parametri in telo zahteve se posredujejo pozicijsko. Preostali neobvezni parametri se zberejo v en sam objekt Api<Operation>Options, ki je zadnji argument. Operacije brez neobveznih parametrov ne uporabljajo objekta možnosti.
Primer: Pridobivanje komentarjev
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"
Opombe 
ID-ji oddaj
Opazili boste, da morate v nekaterih klicih API posredovati broadcastId. Ko prejmete dogodke, boste ta ID prejeli nazaj, zato boste vedeli, naj dogodek prezrete, če nameravate optimistično uporabiti spremembe na odjemalcu
(kar boste verjetno želeli narediti, saj zagotavlja najboljšo izkušnjo). Tukaj posredujte UUID. ID naj bo dovolj edinstven, da se v eni seji brskalnika ne pojavi dvakrat.
SSO (Enkratna prijava)
Za primere SSO glejte spodaj.
Uporaba SSO 
Enostaven 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
Varen 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
Dokumentacija za fastcomments 
Dokumentacija za API končne točke
All URIs are relative to https://fastcomments.com
| Razred | Metoda | HTTP zahteva | 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 | Združi dokumente z njihovim grupiranjem (če je podan parameter groupBy) in uporabo več operacij. Podprte so različne operacije (npr. sum, countDistinct, avg itd.). |
| 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 | Prejšnji komentatorji na strani, KI NI Trenutno online. Razvrščeni po displayName. Uporabite to po izčrpanju /users/online za prikaz razdelka „Člani“. Premikanje po kazalniku (cursor) na commenterName: strežnik sprehaja delni indeks {tenantId, urlId, commenterName} od afterName naprej z $gt, brez $skip stroškov. |
| PublicApi | getOnlineUsers | GET /pages/{tenantId}/users/online | Trenutno‑online gledalci strani: ljudje, katerih WebSocket seja je trenutno naročena na to stran. Vrne anonCount + totalCount (število naročnikov v sobi, vključno z anonimiziranimi gledalci, ki jih ne naštejemo). |
| PublicApi | getPagesPublic | GET /pages/{tenantId} | Seznam strani za najemnika. Uporablja ga namizni odjemalec FChat za napolnitev seznama sob. Zahteva, da je enableFChat nastavljen na true v razrešenih prilagojenih nastavitvah za vsako stran. Strani, ki zahtevajo SSO, se filtrirajo glede na skupinski dostop zahtevajočega uporabnika. |
| 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 | Zbirni uporabniški podatki za najemnika. Za podane userIds se vrnejo prikazni podatki iz User / SSOUser. Uporablja jih vtičnik komentarjev za obogatitev uporabnikov, ki se pravkar pojavijo preko dogodka prisotnosti. Brez konteksta strani: zasebnost je enotno uveljavljena (zasebni profili so maskirani). |
| 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} | Omogoči ali onemogoči obvestila za določen komentar. |
| PublicApi | updateUserNotificationPageSubscriptionStatus | POST /user-notifications/set-subscription-state/{subscribedOrUnsubscribed} | Omogoči ali onemogoči obvestila za stran. Ko so uporabniki naročeni na stran, se ustvarjajo obvestila za nove korenske komentarje, in tudi |
| PublicApi | updateUserNotificationStatus | POST /user-notifications/{notificationId}/mark/{newStatus} | |
| PublicApi | uploadImage | POST /upload-image/{tenantId} | Naloži in spremeni velikost slike |
| PublicApi | voteComment | POST /comments/{tenantId}/{commentId}/vote |
Dokumentacija za modele
- 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
- CommentQuestionsRequired
- CommentTextUpdateRequest
- CommentThreadDeletionMode
- CommentUserBadgeInfo
- CommentUserHashTagInfo
- CommentUserMentionInfo
- CommenterNameFormats
- CommentsByIdsParams
- CreateAPIPageData
- CreateAPISSOUserData
- CreateAPIUserSubscriptionData
- CreateCommentParams
- CreateEmailTemplateBody
- CreateEmailTemplateResponse
- CreateFeedPostParams
- CreateFeedPostResponse
- CreateFeedPostsResponse
- CreateHashTagBody
- [CreateHashTagResponse](https://github.com/FastComments/fastcomments-nim/blob/master/docs/Models/Create
aggregate 
Aggregates documents by grouping them (if groupBy is provided) and applying multiple operations. Different operations (e.g. sum, countDistinct, avg, etc.) are supported.
Parametri
| Ime | Vrsta | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| aggregationRequest | AggregationRequest | No | |
| options | AggregateOptions | No |
Odgovor
Vrne: Option[AggregateResponse]
Primer

getAuditLogs 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| options | GetAuditLogsOptions | Ne |
Odziv
Vrne: Option[GetAuditLogsResponse]
Primer

logoutPublic 
Odgovor
Vrne: Option[APIEmptyResponse]
Primer

blockFromCommentPublic 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| publicBlockFromCommentParams | PublicBlockFromCommentParams | No | |
| sso | string = "" | No |
Odgovor
Vrne: Option[BlockSuccess]
Primer

unBlockCommentPublic 
Parameters
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| commentId | string | Da | |
| publicBlockFromCommentParams | PublicBlockFromCommentParams | Ne | |
| sso | string = "" | Ne |
Response
Vrne: Option[UnblockSuccess]
Example

checkedCommentsForBlocked 
Parameters
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| commentIds | string | No | |
| sso | string = "" | No |
Response
Vrne: Option[CheckBlockedCommentsResponse]
Primer

blockUserFromComment 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| id | string | Ne | |
| blockFromCommentParams | BlockFromCommentParams | Ne | |
| options | BlockUserFromCommentOptions | Ne |
Odgovor
Vrne: Option[BlockSuccess]
Primer

createCommentPublic 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| urlId | string | Yes | |
| broadcastId | string | No | |
| commentData | CommentData | No | |
| options | CreateCommentPublicOptions | No |
Odgovor
Vrne: Option[SaveCommentsResponseWithPresence]
Primer

deleteComment 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| id | string | Ne | |
| options | DeleteCommentOptions | Ne |
Odgovor
Vrne: Option[DeleteCommentResult]
Primer

deleteCommentPublic 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| options | DeleteCommentPublicOptions | No |
Odgovor
Vrne: Option[PublicAPIDeleteCommentResponse]
Primer

deleteCommentVote 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| voteId | string | No | |
| urlId | string | Yes | |
| broadcastId | string | No | |
| options | DeleteCommentVoteOptions | No |
Odgovor
Vrne: Option[VoteDeleteResponse]
Primer

flagComment 
Parametri
| Ime | Tip | Zahtevano | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| id | string | Ne | |
| options | FlagCommentOptions | Ne |
Odgovor
Vrne: Option[FlagCommentResponse]
Primer

getComment 
Parameters
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| id | string | Ne |
Odgovor
Vrne: Option[APIGetCommentResponse]
Primer

getComments 
Parametri
| Ime | Vrsta | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| options | GetCommentsOptions | Ne |
Odgovor
Returns: Option[APIGetCommentsResponse]
Primer

getCommentsPublic 
req tenantId urlId
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| urlId | string | Da | |
| options | GetCommentsPublicOptions | Ne |
Odgovor
Vrne: Option[GetCommentsResponseWithPresencePublicComment]
Primer

getCommentText 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| commentId | string | Da | |
| options | GetCommentTextOptions | Ne |
Odgovor
Vrne: Option[PublicAPIGetCommentTextResponse]
Primer

getCommentVoteUserNames 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| dir | int | No | |
| sso | string = "" | No |
Odziv
Vrne: Option[GetCommentVoteUserNamesSuccessResponse]
Primer

lockComment 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| sso | string = "" | No |
Odgovor
Vrne: Option[APIEmptyResponse]
Primer

pinComment 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| commentId | string | Da | |
| broadcastId | string | Ne | |
| sso | string = "" | Ne |
Odgovor
Vrne: Option[ChangeCommentPinStatusResponse]
Primer

saveComment 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| createCommentParams | CreateCommentParams | No | |
| options | SaveCommentOptions | No |
Odgovor
Vrne: Option[APISaveCommentResponse]
Primer

saveCommentsBulk 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| createCommentParams | seq[CreateCommentParams] | Ne | |
| options | SaveCommentsBulkOptions): (Option[seq[SaveCommentsBulkResponse]] | Ne | |
| id | string | Ne | |
| fromName | string | Ne |
Odgovor
Vrne: Option[APIEmptyResponse]
Primer

setCommentText 
Parametri
| Ime | Vrsta | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| commentId | string | Da | |
| broadcastId | string | Ne | |
| commentTextUpdateRequest | CommentTextUpdateRequest | Ne | |
| options | SetCommentTextOptions | Ne |
Odziv
Vrne: Option[PublicAPISetCommentTextResponse]
Primer

unBlockUserFromComment 
Parameteri
| Ime | Vrsta | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| unBlockFromCommentParams | UnBlockFromCommentParams | No | |
| options | UnBlockUserFromCommentOptions | No |
Odgovor
Vrne: Option[UnblockSuccess]
Primer

unFlagComment 
Parametri
| Ime | Tip | Zahtevano | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| id | string | Ne | |
| options | UnFlagCommentOptions | Ne |
Odgovor
Vrne: Option[FlagCommentResponse]
Primer

unLockComment 
Parametri
| Ime | Vrsta | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| commentId | string | Da | |
| broadcastId | string | Ne | |
| sso | string = "" | Ne |
Odgovor
Vrne: Option[APIEmptyResponse]
Primer

unPinComment 
Parametri
| Ime | Vrsta | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| commentId | string | Da | |
| broadcastId | string | Ne | |
| sso | string = "" | Ne |
Odgovor
Vrne: Option[ChangeCommentPinStatusResponse]
Primer

updateComment 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| updatableCommentParams | UpdatableCommentParams | No | |
| options | UpdateCommentOptions | No |
Odziv
Vrne: Option[APIEmptyResponse]
Primer

voteComment 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| commentId | string | Da | |
| urlId | string | Da | |
| broadcastId | string | Ne | |
| voteBodyParams | VoteBodyParams | Ne | |
| options | VoteCommentOptions | Ne |
Odgovor
Vrne: Option[VoteResponse]
Primer

getCommentsForUser 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| options | GetCommentsForUserOptions | Ne |
Odgovor
Vrne: Option[GetCommentsForUserResponse]
Primer

addDomainConfig 
Parametri
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| addDomainConfigParams | AddDomainConfigParams | No |
Odgovor
Vrne: Option[AddDomainConfigResponse]
Primer

deleteDomainConfig 
Parametri
| Ime | Tip | Zahtevano | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| domain | string | Ne |
Odziv
Returns: Option[DeleteDomainConfigResponse]
Primer

getDomainConfig 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| domain | string | No |
Odgovor
Vrne: Option[GetDomainConfigResponse]
Primer

getDomainConfigs 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da |
Odgovor
Vrne: Option[GetDomainConfigsResponse]
Primer

patchDomainConfig 
Parametri
| Ime | Vrsta | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| domainToUpdate | string | Ne | |
| patchDomainConfigParams | PatchDomainConfigParams | Ne |
Odgovor
Vrne: Option[PatchDomainConfigResponse]
Primer

putDomainConfig 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| domainToUpdate | string | Ne | |
| updateDomainConfigParams | UpdateDomainConfigParams | Ne |
Odgovor
Vrne: Option[PutDomainConfigResponse]
Primer

createEmailTemplate 
Parametri
| Ime | Vrsta | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| createEmailTemplateBody | CreateEmailTemplateBody | No |
Odziv
Vrne: Option[CreateEmailTemplateResponse]
Primer

deleteEmailTemplate 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| id | string | Ne |
Odgovor
Vrne: Option[APIEmptyResponse]
Primer

deleteEmailTemplateRenderError 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| errorId | string | No |
Odgovor
Vrne: Option[APIEmptyResponse]
Primer

getEmailTemplate 
Parametri
| Ime | Vrsta | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| id | string | Ne |
Odgovor
Vrne: Option[GetEmailTemplateResponse]
Primer

getEmailTemplateDefinitions 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da |
Odgovor
Vrne: Option[GetEmailTemplateDefinitionsResponse]
Primer

getEmailTemplateRenderErrors 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| skip | float64 | No |
Odgovor
Vrne: Option[GetEmailTemplateRenderErrorsResponse]
Primer

getEmailTemplates 
Parametri
| Ime | Vrsta | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| skip | float64 | Ne |
Odgovor
Vrne: Option[GetEmailTemplatesResponse]
Primer

renderEmailTemplate 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| renderEmailTemplateBody | RenderEmailTemplateBody | Ne | |
| locale | string = "" | Ne |
Odgovor
Vrne: Option[RenderEmailTemplateResponse]
Primer

updateEmailTemplate 
Parametri
| Ime | Vrsta | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| updateEmailTemplateBody | UpdateEmailTemplateBody | No |
Odgovor
Vrne: Option[APIEmptyResponse]
Primer

getEventLog 
req tenantId urlId userIdWS
Parametri
| Ime | Vrsta | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| urlId | string | Da | |
| userIdWS | string | Ne | |
| startTime | int64 | Ne | |
| endTime | int64 | Ne |
Odgovor
Vrne: Option[GetEventLogResponse]
Primer

getGlobalEventLog 
req tenantId urlId userIdWS
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| urlId | string | Yes | |
| userIdWS | string | No | |
| startTime | int64 | No | |
| endTime | int64 | No |
Odgovor
Vrne: Option[GetEventLogResponse]
Primer

createFeedPost 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| createFeedPostParams | CreateFeedPostParams | Ne | |
| options | CreateFeedPostOptions | Ne |
Odgovor
Vrne: Option[CreateFeedPostsResponse]
Primer

createFeedPostPublic 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| createFeedPostParams | CreateFeedPostParams | No | |
| options | CreateFeedPostPublicOptions | No |
Odgovor
Vrne: Option[CreateFeedPostResponse]
Primer

deleteFeedPostPublic 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| postId | string | Ne | |
| options | DeleteFeedPostPublicOptions | Ne |
Odgovor
Vrne: Option[DeleteFeedPostPublicResponse]
Primer

getFeedPosts 
req tenantId afterId
Parametri
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Da | |
| options | GetFeedPostsOptions | Ne |
Odgovor
Vrne: Option[GetFeedPostsResponse]
Primer

getFeedPostsPublic 
req tenantId afterId
Parametri
| Ime | Tip | Potrebno | Opis |
|---|---|---|---|
| tenantId | string | Da | |
| options | GetFeedPostsPublicOptions | Ne |
Odgovor
Vrača: Option[PublicFeedPostsResponse]
Primer

getFeedPostsStats 
Parametri
| Ime | Tip | Obvezno | Opis |
|---|---|---|---|
| tenantId | string | Yes | |
| postIds | seq[string] | No | |
| sso | string = "" | No |
Odgovor
Returns: Option[FeedPostsStatsResponse]
Primer
