
Langue 🇨🇦 Français (Canada)
Documentation
Premiers pas
Référence de l'API
Utilisation
Agrégation
Journaux d'audit
Authentification
Bloquer depuis un commentaire
Vérifier les commentaires bloqués
Commentaires
Commentaires pour l'utilisateur
Configurations de domaine
Modèles de courriel
Journal d'événements
Publications
Signaler un commentaire
Gifs
Mots-clics
Modération
Modérateurs
Nombre de notifications
Notifications
Réactions de page
Pages
Événements webhook en attente
Configurations des questions
Résultats des questions
Agrégation des résultats de 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
Statut de présence de l'utilisateur
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 
Utilisation de Nimble
nimble install fastcomments
Compilation à partir du code source
nimble build
Contenu de la bibliothèque
Cette bibliothèque contient le client API généré ainsi que 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 le module 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 offre une suite étendue d’API 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 APIs authentifiées (DefaultAPI)
Important : Les points de terminaison authentifiés exigent que votre clé API soit définie dans l’en‑tête 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"
# Effectuer des appels API authentifiés.
# Les paramètres requis (et le corps de la requête) sont positionnels ; les
# paramètres sont passés via l'objet d'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 APIs publiques (PublicAPI)
Les points de terminaison publics ne nécessitent pas d'authentification :
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 APIs de modération (ModerationAPI)
Les points de terminaison de modération alimentent le tableau de bord des modérateurs et sont authentifiés avec un jeton SSO pour le modérateur agissant :
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
- Erreur d'authentification 401 : 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 d'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.
Effectuer des appels API 
Toutes les méthodes d’API dans ce SDK renvoient des tuples de (Option[ResponseType], Response). Le premier élément contient la réponse analysée si la requête réussit, et le deuxième élément est la réponse HTTP brute.
Les paramètres requis et le corps de la requête sont passés positionnellement. Les paramètres optionnels restants sont regroupés dans un seul objet Api<Operation>Options, qui constitue le dernier argument. Les opérations qui n’ont pas de paramètres optionnels n’utilisent 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"
Remarques 
Identifiants de diffusion
Vous verrez que vous devez transmettre un broadcastId dans certains appels d'API. Lorsque vous recevez des événements, vous recevrez cet ID en retour, ce qui vous permet de savoir quand ignorer l'événement si vous prévoyez d'appliquer des modifications de façon optimiste côté client
(ce que vous voudrez probablement faire, car cela offre la meilleure expérience). Transmettez un UUID ici. L'ID doit être suffisamment unique pour ne pas apparaître deux fois au cours d'une session de navigateur.
SSO (Authentification unique)
Pour des exemples d'authentification unique, voir ci‑dessous.
Utilisation du 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’accès API
Tous les URI sont relatifs à 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. sum, countDistinct, avg, 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 précédents de la page qui ne sont PAS actuellement en ligne. Triés par displayName. Utilisez ceci après avoir épuisé /users/online pour rendre une section « Membres ». Pagination par curseur sur commenterName : le serveur parcourt l’index partiel {tenantId, urlId, commenterName} à partir de afterName en avant 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 à toute la salle, y compris les spectateurs anonymes que nous n’énumérons pas). |
| PublicApi | getPagesPublic | GET /pages/{tenantId} | Répertorie 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 nécessitent SSO sont filtrées selon l’accès aux groupes 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 d’utilisateurs en masse pour un locataire. Donnés des userIds, renvoie 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](https://github.com/FastComments/fastcomments
aggregate 
Agrège les documents en les regroupant (si groupBy est fourni) et en appliquant plusieurs opérations.
Différentes opérations (par ex. sum, countDistinct, avg, etc.) sont prises en charge.
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| aggregationRequest | AggregationRequest | Non | |
| options | AggregateOptions | Non |
Réponse
Renvoie : Option[AggregateResponse]
Exemple

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

logoutPublic 
Réponse
Renvoie: Option[APIEmptyResponse]
Exemple

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

unBlockCommentPublic 
Paramètres
| Nom | 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
Renvoie : Option[BlockSuccess]
Exemple

createCommentPublic 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| urlId | string | Oui | |
| broadcastId | string | Non | |
| commentData | CommentData | Non | |
| options | CreateCommentPublicOptions | Non |
Réponse
Renvoie : Option[SaveCommentsResponseWithPresence]
Exemple

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

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

deleteCommentVote 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| commentId | string | Oui | |
| voteId | string | Non | |
| urlId | string | Oui | |
| broadcastId | string | Non | |
| options | DeleteCommentVoteOptions | Non |
Réponse
Renvoie : Option[VoteDeleteResponse]
Exemple

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

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

getComments 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| options | GetCommentsOptions | No |
Réponse
Renvoie : 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 | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| commentId | string | Oui | |
| options | GetCommentTextOptions | Non |
Réponse
Retourne : Option[PublicAPIGetCommentTextResponse]
Exemple

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

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

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

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

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

setCommentText 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| commentId | string | Oui | |
| broadcastId | string | Non | |
| commentTextUpdateRequest | CommentTextUpdateRequest | Non | |
| options | SetCommentTextOptions | Non |
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 | Yes | |
| id | string | No | |
| options | UnFlagCommentOptions | No |
Réponse
Renvoie : Option[FlagCommentResponse]
Exemple

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

unPinComment 
Paramètres
| Name | Type | Required | Description |
|---|---|---|---|
| tenantId | string | Yes | |
| commentId | string | Yes | |
| broadcastId | string | No | |
| sso | string = "" | No |
Réponse
Retourne : Option[ChangeCommentPinStatusResponse]
Exemple

updateComment 
Paramètres
| Name | Type | Requis | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| id | string | Non | |
| updatableCommentParams | UpdatableCommentParams | Non | |
| options | UpdateCommentOptions | Non |
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
Renvoie: Option[AddDomainConfigResponse]
Exemple

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

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

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

patchDomainConfig 
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| domainToUpdate | string | Non | |
| patchDomainConfigParams | PatchDomainConfigParams | Non |
Réponse
Retourne : Option[PatchDomainConfigResponse]
Exemple

putDomainConfig 
Paramètres
| Name | Type | Required | 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 | Oui | |
| createEmailTemplateBody | CreateEmailTemplateBody | Non |
Réponse
Retourne : Option[CreateEmailTemplateResponse]
Exemple

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

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

getEmailTemplate 
Paramètres
| Name | Type | Required | 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 | Oui | |
| id | string | Non | |
| skip | float64 | Non |
Réponse
Renvoie : Option[GetEmailTemplateRenderErrorsResponse]
Exemple

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

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

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

getEventLog 
req 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
Retourne: Option[GetEventLogResponse]
Exemple

getGlobalEventLog 
req 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
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| createFeedPostParams | CreateFeedPostParams | Non | |
| options | CreateFeedPostOptions | Non |
Réponse
Renvoie : 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 | Yes | |
| postId | string | No | |
| options | DeleteFeedPostPublicOptions | No |
Réponse
Retourne : Option[DeleteFeedPostPublicResponse]
Exemple

getFeedPosts 
req tenantId afterId
Paramètres
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| tenantId | string | Oui | |
| options | GetFeedPostsOptions | Non |
Réponse
Retourne : 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
Retourne : Option[FeedPostsStatsResponse]
Exemple
