
Langue 🇫🇷 Français (France)
Documentation
Premiers pas
Référence API
Utilisation
Agrégation
Journaux d'audit
Authentification
Blocage depuis un commentaire
Vérifier les commentaires bloqués
Commentaires
Commentaires pour l'utilisateur
Configurations de domaine
Modèles d'e-mail
Journal des événements
Publications du fil
Signaler un commentaire
GIFs
Hashtags
Modération
Modérateurs
Nombre de notifications
Notifications
Réactions de page
Pages
Événements webhook en attente
Configurations de question
Résultats des questions
Agrégation des résultats des questions
Utilisateurs SSO
Abonnements
Utilisation quotidienne du locataire
Forfaits du locataire
Utilisateurs du locataire
Locataires
Tickets
Traductions
Téléverser une image
Progression des badges utilisateur
Badges utilisateur
Notifications utilisateur
Statuts de présence des utilisateurs
Recherche d'utilisateurs
Utilisateurs
Votes
SDK Nim de FastComments
Ceci est le SDK Nim officiel pour FastComments.
SDK Nim officiel pour l'API FastComments
Dépôt
Installation 
Utiliser Nimble
nimble install fastcomments
Compilation depuis le code source
nimble build
Contenu de la bibliothèque
Cette bibliothèque contient le client API généré et les utilitaires SSO pour faciliter l’utilisation de l’API.
APIs publiques vs sécurisées
Pour le client API, il existe trois modules API : api_default, api_public et api_moderation. Le module api_default contient des méthodes qui nécessitent votre clé API, et api_public contient des appels API qui peuvent être effectués directement depuis un navigateur, un appareil mobile, etc., sans authentification. Le module api_moderation contient des méthodes pour le tableau de bord du modérateur.
Le module api_moderation fournit une suite étendue d’APIs de modération en temps réel et rapides. Chaque méthode api_moderation accepte un paramètre sso et peut s’authentifier via SSO ou un cookie de session FastComments.com.
Démarrage rapide 
Utilisation des API authentifiées (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"
# Effectuer des appels API authentifiés.
# Les paramètres requis (et le corps de la requête) sont positionnels ; les paramètres optionnels sont passés via l'objet options de l'opération.
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"
Utilisation des API publiques (PublicAPI)
Public endpoints don't require authentication:
import httpclient
import fastcomments
import fastcomments/apis/api_public
let client = newHttpClient()
# Effectuer des appels API publics.
# tenantId et urlId sont requis (positionnels) ; tout le reste est optionnel.
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"
Utilisation des API de modération (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()
# Lister les commentaires dans le tableau de bord de modération.
# Cette opération n'a aucun paramètre requis, donc tout est optionnel.
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"
Problèmes courants
- 401 error d'authentification : Assurez‑vous de définir l'en-tête
x-api-keysur votre HttpClient avant d'effectuer des requêtes DefaultAPI :client.headers["x-api-key"] = "your-api-key" - Classe API incorrecte : Utilisez
api_defaultpour les requêtes authentifiées côté serveur,api_publicpour les requêtes côté client/public, etapi_moderationpour les requêtes du tableau de bord des modérateurs.
Appels d'API 
Toutes les méthodes API de ce SDK renvoient des tuples de (Option[ResponseType], Response). Le premier élément contient la réponse analysée en cas de succès, et le deuxième élément est la réponse HTTP brute.
Les paramètres obligatoires et le corps de la requête sont passés positionnellement. Les paramètres optionnels restants sont rassemblés dans un seul objet Api<Operation>Options, qui est le dernier argument. Les opérations sans paramètres optionnels ne prennent aucun objet d'options.
Exemple : Récupération des commentaires
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"
Notes 
Identifiants de diffusion
Vous verrez que vous devez passer un broadcastId dans certaines requêtes API. Lorsque vous recevrez des événements, vous récupérerez cet ID, ce qui vous permettra d'ignorer l'événement si vous comptez appliquer les changements de façon optimiste côté client (ce que vous voudrez probablement faire car cela offre la meilleure expérience). Passez un UUID ici. L'ID doit être suffisamment unique pour ne pas se produire deux fois dans une session de navigateur.
SSO (Authentification unique)
Pour des exemples de SSO, voir ci-dessous.
Utilisation SSO 
SSO simple
import fastcomments/sso
let user = newSimpleSSOUserData(
userId = "user-123",
email = "user@example.com",
avatar = "https://example.com/avatar.jpg"
)
let sso = newSimple(simpleUserData = user)
let token = sso.createToken()
echo "SSO Token: ", token
SSO sécurisé
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
Documentation pour FastComments 
Documentation des points d’API
All URIs are relative to https://fastcomments.com
| Classe | Méthode | Requête HTTP | Description |
|---|---|---|---|
| DefaultApi | addDomainConfig | POST /api/v1/domain-configs | |
| DefaultApi | addHashTag | POST /api/v1/hash-tags | |
| DefaultApi | addHashTagsBulk | POST /api/v1/hash-tags/bulk | |
| DefaultApi | addPage | POST /api/v1/pages | |
| DefaultApi | addSSOUser | POST /api/v1/sso-users | |
| DefaultApi | aggregate | POST /api/v1/aggregate | Agrège les documents en les regroupant (si groupBy est fourni) et en appliquant plusieurs opérations. Différentes opérations (par ex. somme, countDistinct, moyenne, etc.) sont prises en charge. |
| 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 | Commentateurs antérieurs sur la page QUI NE sont PAS actuellement en ligne. Triés par displayName. Utilisez ceci après avoir épuisé /users/online pour générer une section « Membres ». Pagination par curseur sur commenterName : le serveur parcourt l’index partiel {tenantId, urlId, commenterName} depuis afterName via $gt, sans coût $skip. |
| PublicApi | getOnlineUsers | GET /pages/{tenantId}/users/online | Spectateurs actuellement en ligne d’une page : personnes dont la session websocket est abonnée à la page en ce moment. Retourne anonCount + totalCount (abonnés à la salle, y compris les visiteurs anonymes que nous n’énumérons pas). |
| PublicApi | getPagesPublic | GET /pages/{tenantId} | Liste les pages d’un locataire. Utilisé par le client de bureau FChat pour remplir sa liste de salles. Nécessite que enableFChat soit vrai dans la configuration personnalisée résolue pour chaque page. Les pages qui requièrent le SSO sont filtrées selon le groupe d’accès de l’utilisateur demandeur. |
| 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 | Informations utilisateur en masse pour un locataire. Étant donné des userIds, retourne les informations d’affichage provenant de User / SSOUser. Utilisé par le widget de commentaire pour enrichir les utilisateurs qui viennent d’apparaître via un événement de présence. Aucun contexte de page : la confidentialité est appliquée uniformément (les profils privés sont masqués). |
| 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} | Activer ou désactiver les notifications pour un commentaire spécifique. |
| PublicApi | updateUserNotificationPageSubscriptionStatus | POST /user-notifications/set-subscription-state/{subscribedOrUnsubscribed} | Activer ou désactiver les notifications pour une page. Lorsque les utilisateurs sont abonnés à une page, des notifications sont créées pour les nouveaux commentaires racine, et aussi |
| PublicApi | updateUserNotificationStatus | POST /user-notifications/{notificationId}/mark/{newStatus} | |
| PublicApi | uploadImage | POST /upload-image/{tenantId} | Télécharger et redimensionner une image |
| PublicApi | voteComment | POST /comments/{tenantId}/{commentId}/vote |
Documentation des modèles
- 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
- CreateModeratorBody
- CreateModeratorResponse
- [
aggregate 
Aggregates documents by grouping them (if groupBy is provided) and applying multiple operations. Different operations (e.g. sum, countDistinct, avg, etc.) are supported.
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| aggregationRequest | AggregationRequest | No | |
| options | AggregateOptions | No |
Réponse
Returns: Option[AggregateResponse]
Exemple

getAuditLogs 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| options | GetAuditLogsOptions | No |
Réponse
Retourne : Option[GetAuditLogsResponse]
Exemple

logoutPublic 
Réponse
Renvoie : Option[APIEmptyResponse]
Exemple

blockFromCommentPublic 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| commentId | string | Oui | |
| publicBlockFromCommentParams | PublicBlockFromCommentParams | Non | |
| sso | string = "" | Non |
Réponse
Renvoie : Option[BlockSuccess]
Exemple

unBlockCommentPublic 
Paramètres
| Name | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| commentId | string | Oui | |
| publicBlockFromCommentParams | PublicBlockFromCommentParams | Non | |
| sso | string = "" | Non |
Réponse
Retourne : Option[UnblockSuccess]
Exemple

checkedCommentsForBlocked 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| commentIds | string | Non | |
| sso | string = "" | Non |
Réponse
Renvoie : Option[CheckBlockedCommentsResponse]
Exemple

blockUserFromComment 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| id | string | Non | |
| blockFromCommentParams | BlockFromCommentParams | Non | |
| options | BlockUserFromCommentOptions | Non |
Réponse
Retourne : Option[BlockSuccess]
Exemple

createCommentPublic 
Paramètres
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| urlId | string | Yes | |
| broadcastId | string | No | |
| commentData | CommentData | No | |
| options | CreateCommentPublicOptions | No |
Réponse
Renvoie : Option[SaveCommentsResponseWithPresence]
Exemple

deleteComment 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| options | DeleteCommentOptions | No |
Réponse
Retourne : Option[DeleteCommentResult]
Exemple

deleteCommentPublic 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| options | DeleteCommentPublicOptions | No |
Réponse
Retourne : Option[PublicAPIDeleteCommentResponse]
Exemple

deleteCommentVote 
Parameters
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| commentId | string | Oui | |
| voteId | string | Non | |
| urlId | string | Oui | |
| broadcastId | string | Non | |
| options | DeleteCommentVoteOptions | Non |
Response
Retourne : Option[VoteDeleteResponse]
Exemple

flagComment 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| id | string | Non | |
| options | FlagCommentOptions | Non |
Réponse
Retourne : Option[FlagCommentResponse]
Exemple

getComment 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| id | string | Non |
Réponse
Retourne : Option[APIGetCommentResponse]
Exemple

getComments 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| options | GetCommentsOptions | No |
Réponse
Returns: Option[APIGetCommentsResponse]
Exemple

getCommentsPublic 
req tenantId urlId
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| urlId | string | Oui | |
| options | GetCommentsPublicOptions | Non |
Réponse
Renvoie : Option[GetCommentsResponseWithPresencePublicComment]
Exemple

getCommentText 
Paramètres
| Nom | Type | Requis | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| options | GetCommentTextOptions | No |
Réponse
Retourne : Option[PublicAPIGetCommentTextResponse]
Exemple

getCommentVoteUserNames 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| commentId | string | Oui | |
| dir | int | Non | |
| sso | string = "" | Non |
Réponse
Renvoie : Option[GetCommentVoteUserNamesSuccessResponse]
Exemple

lockComment 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| sso | string = "" | No |
Réponse
Renvoie : Option[APIEmptyResponse]
Exemple

pinComment 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| sso | string = "" | No |
Réponse
Renvoie : Option[ChangeCommentPinStatusResponse]
Exemple

saveComment 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| createCommentParams | CreateCommentParams | Non | |
| options | SaveCommentOptions | Non |
Réponse
Retourne : Option[APISaveCommentResponse]
Exemple

saveCommentsBulk 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| createCommentParams | seq[CreateCommentParams] | Non | |
| options | SaveCommentsBulkOptions): (Option[seq[SaveCommentsBulkResponse]] | Non | |
| id | string | Non | |
| fromName | string | Non |
Réponse
Retourne : Option[APIEmptyResponse]
Exemple

setCommentText 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| commentTextUpdateRequest | CommentTextUpdateRequest | No | |
| options | SetCommentTextOptions | No |
Réponse
Retourne : Option[PublicAPISetCommentTextResponse]
Exemple

unBlockUserFromComment 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| id | string | Non | |
| unBlockFromCommentParams | UnBlockFromCommentParams | Non | |
| options | UnBlockUserFromCommentOptions | Non |
Réponse
Renvoie : Option[UnblockSuccess]
Exemple

unFlagComment 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| id | string | Non | |
| options | UnFlagCommentOptions | Non |
Réponse
Retourne : Option[FlagCommentResponse]
Exemple

unLockComment 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| commentId | string | Oui | |
| broadcastId | string | Non | |
| sso | string = "" | Non |
Réponse
Retourne : Option[APIEmptyResponse]
Exemple

unPinComment 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| commentId | string | Oui | |
| broadcastId | string | Non | |
| sso | string = "" | Non |
Réponse
Retourne : Option[ChangeCommentPinStatusResponse]
Exemple

updateComment 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| updatableCommentParams | UpdatableCommentParams | No | |
| options | UpdateCommentOptions | No |
Réponse
Retourne : Option[APIEmptyResponse]
Exemple

voteComment 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| commentId | string | Oui | |
| urlId | string | Oui | |
| broadcastId | string | Non | |
| voteBodyParams | VoteBodyParams | Non | |
| options | VoteCommentOptions | Non |
Réponse
Retourne : Option[VoteResponse]
Exemple

getCommentsForUser 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| options | GetCommentsForUserOptions | Non |
Réponse
Retourne : Option[GetCommentsForUserResponse]
Exemple

addDomainConfig 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| addDomainConfigParams | AddDomainConfigParams | Non |
Réponse
Retourne : Option[AddDomainConfigResponse]
Exemple

deleteDomainConfig 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| domain | string | Non |
Réponse
Retourne : Option[DeleteDomainConfigResponse]
Exemple

getDomainConfig 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| domain | string | No |
Réponse
Retourne : Option[GetDomainConfigResponse]
Exemple

getDomainConfigs 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes |
Réponse
Renvoie : Option[GetDomainConfigsResponse]
Exemple

patchDomainConfig 
Paramètres
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| domainToUpdate | string | No | |
| patchDomainConfigParams | PatchDomainConfigParams | No |
Réponse
Retourne : Option[PatchDomainConfigResponse]
Exemple

putDomainConfig 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| domainToUpdate | string | No | |
| updateDomainConfigParams | UpdateDomainConfigParams | No |
Réponse
Retourne : Option[PutDomainConfigResponse]
Exemple

createEmailTemplate 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| createEmailTemplateBody | CreateEmailTemplateBody | No |
Réponse
Retourne : Option[CreateEmailTemplateResponse]
Exemple

deleteEmailTemplate 
Parameters
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No |
Réponse
Renvoie : Option[APIEmptyResponse]
Exemple

deleteEmailTemplateRenderError 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| id | string | Non | |
| errorId | string | Non |
Réponse
Renvoie : Option[APIEmptyResponse]
Exemple

getEmailTemplate 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| id | string | Non |
Réponse
Renvoie : Option[GetEmailTemplateResponse]
Exemple

getEmailTemplateDefinitions 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui |
Réponse
Renvoie : Option[GetEmailTemplateDefinitionsResponse]
Exemple

getEmailTemplateRenderErrors 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| id | string | No | |
| skip | float64 | No |
Réponse
Retourne : Option[GetEmailTemplateRenderErrorsResponse]
Exemple

getEmailTemplates 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| skip | float64 | Non |
Réponse
Retourne : Option[GetEmailTemplatesResponse]
Exemple

renderEmailTemplate 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| renderEmailTemplateBody | RenderEmailTemplateBody | No | |
| locale | string = "" | No |
Réponse
Renvoie : Option[RenderEmailTemplateResponse]
Exemple

updateEmailTemplate 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| id | string | Non | |
| updateEmailTemplateBody | UpdateEmailTemplateBody | Non |
Réponse
Renvoie : Option[APIEmptyResponse]
Exemple

getEventLog 
req tenantId urlId userIdWS
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| urlId | string | Yes | |
| userIdWS | string | No | |
| startTime | int64 | No | |
| endTime | int64 | No |
Réponse
Renvoie : Option[GetEventLogResponse]
Exemple

getGlobalEventLog 
requête tenantId urlId userIdWS
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| urlId | string | Oui | |
| userIdWS | string | Non | |
| startTime | int64 | Non | |
| endTime | int64 | Non |
Réponse
Renvoie : Option[GetEventLogResponse]
Exemple

createFeedPost 
Paramètres
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| createFeedPostParams | CreateFeedPostParams | No | |
| options | CreateFeedPostOptions | No |
Réponse
Retourne : Option[CreateFeedPostsResponse]
Exemple

createFeedPostPublic 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| createFeedPostParams | CreateFeedPostParams | Non | |
| options | CreateFeedPostPublicOptions | Non |
Réponse
Renvoie : Option[CreateFeedPostResponse]
Exemple

deleteFeedPostPublic 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| postId | string | Non | |
| options | DeleteFeedPostPublicOptions | Non |
Réponse
Retourne : Option[DeleteFeedPostPublicResponse]
Exemple

getFeedPosts 
req tenantId afterId
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| options | GetFeedPostsOptions | Non |
Réponse
Renvoie : Option[GetFeedPostsResponse]
Exemple

getFeedPostsPublic 
req tenantId afterId
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| options | GetFeedPostsPublicOptions | Non |
Réponse
Renvoie : Option[PublicFeedPostsResponse]
Exemple

getFeedPostsStats 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| postIds | seq[string] | Non | |
| sso | string = "" | Non |
Réponse
Returns: Option[FeedPostsStatsResponse]
Exemple
