FastComments JavaScript/TypeScript SDK

Ово је званични JavaScript/TypeScript SDK за FastComments.

Званични JavaScript/TypeScript SDK за FastComments API

Репозиторијум

Инсталација

npm install fastcomments-sdk

API документација

Kompletna API referenca: docs/api/README.md

Компатибилност прегледача и сервера

Овај SDK користи два улазна пута да обезбеди оптималну компатибилност и спречи грешке при извршавању:

fastcomments-sdk/browser - Верзија безбедна за прегледаче са нативним fetch
fastcomments-sdk/server - Пуна Node.js верзија са подршком за SSO
fastcomments-sdk (подразумевано) - Само типови, безбедно за увоз било где

Употреба

Овај SDK пружа одвојене улазне тачке за окружења прегледача и сервера како би обезбедио оптималну компатибилност и безбедност:

Коришћење у прегледачу (клијентска страна)

За апликације у прегледачу/фронт‑енда, користите извоз погодан за прегледач који искључује Node.js зависности:

// Увоз погодан за прегледач (нема Node.js зависности)
import { createFastCommentsBrowserSDK } from 'fastcomments-sdk/browser';

// Креирај инстанцу SDK за прегледач
const sdk = createFastCommentsBrowserSDK({
  basePath: 'https://fastcomments.com' // опционално, подразумева се https://fastcomments.com
});

// Користи јавне API-је (није потребан API кључ - безбедно за прегледаче)
const comments = await sdk.publicApi.getCommentsPublic({ 
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id'
});

Коришћење на серверу (Node.js)

За серверске/бекенд апликације користите пун SDK са SSO и функцијама аутентификације:

// Увоз за сервер (укључује SSO и дизајниран да ради са NodeJS)
import { createFastCommentsSDK } from 'fastcomments-sdk/server';

// Креирај инстанцу SDK за сервер
const sdk = createFastCommentsSDK({
  apiKey: 'your-api-key', // Чувај ово као тајну на серверу!
  basePath: 'https://fastcomments.com' // опционално, подразумева се https://fastcomments.com
});

// Користи обезбеђене API-је са твојим API кључем
const comments = await sdk.defaultApi.getComments({ 
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id'
});

Увоз само типова

Ако су ти потребни само TypeScript типови (нема извршног кода), користи подразумевани увоз:

// Само типови (нема извршних зависности - безбедно свуда)
import type { 
  PublicComment, 
  CreateCommentParams, 
  GetCommentsPublic200Response 
} from 'fastcomments-sdk';

Коришћење појединачних API класа

Окружење прегледача

import { PublicApi, Configuration } from 'fastcomments-sdk/browser';

const config = new Configuration({
  basePath: 'https://fastcomments.com'
});

const publicApi = new PublicApi(config);

Серверско окружење

import { DefaultApi, PublicApi, Configuration } from 'fastcomments-sdk/server';

const config = new Configuration({
  apiKey: 'your-api-key',
  basePath: 'https://fastcomments.com'
});

const defaultApi = new DefaultApi(config);
const publicApi = new PublicApi(config);

Јавни и заштићени API-ји

SDK pruža tri glavne API klase:

DefaultApi - Zaštićeni endpointi koji zahtijevaju vaš API ključ za autentifikaciju. Koristite ih za serverske operacije.
PublicApi - Javni endpointi kojima se može pristupiti bez API ključa. Mogu se pozivati direktno iz preglednika/mobilnih uređaja/itd.
HiddenApi - Interni/administratorski endpointi za napredne slučajeve upotrebe.

Primjer: Korištenje Public API (sigurno za preglednik)

import { PublicApi } from 'fastcomments-sdk/browser';

const publicApi = new PublicApi();

// Preuzmi komentare za stranicu (nije potreban API ključ)
const response = await publicApi.getCommentsPublic({
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id'
});

Primjer: Korištenje Default API (samo na serverskoj strani)

import { DefaultApi, Configuration } from 'fastcomments-sdk/server';

const config = new Configuration({
  apiKey: 'your-api-key' // Čuvajte ovo u tajnosti!
});
const defaultApi = new DefaultApi(config);

// Preuzmi komentare sa punim administratorskim pristupom
const response = await defaultApi.getComments({
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id'
});

SSO (једнократно пријављивање) интеграција

FastComments подржава SSO за интеграцију са вашим постојећим системом аутентификације корисника. Функционалност SSO је доступна само у server export-у јер захтева Node.js crypto функције.

Једноставан SSO (само на серверу)

Једноставан SSO треба да буде генерисан на серверу и послат клијенту:

// Server-side code (Node.js/backend)
import { FastCommentsSSO, PublicApi } from 'fastcomments-sdk/server';

// Create simple SSO using the built-in helper  
const userData = {
  username: 'john_doe',
  email: 'john@example.com',
  displayName: 'John Doe',
  avatar: 'https://example.com/avatar.jpg'
};

const sso = FastCommentsSSO.createSimple(userData, {
  loginURL: '/login',
  logoutURL: '/logout'
});

const ssoToken = sso.createToken();

// Send ssoToken to your client-side code
// Client-side code can then use this token with the browser SDK

Сигуран SSO (на серверу, препоручено)

Сигуран SSO треба да буде имплементиран на серверу и пружа бољу сигурност:

// Server-side code (Node.js/backend)
import { FastCommentsSSO, PublicApi } from 'fastcomments-sdk/server';

// Create secure SSO using the built-in helper
const userData = {
  id: 'user-123',
  email: 'john@example.com',
  username: 'john_doe',
  displayName: 'John Doe',
  avatar: 'https://example.com/avatar.jpg',
  isAdmin: false,
  isModerator: false
};

const sso = FastCommentsSSO.createSecure('your-api-key', userData, {
  loginURL: '/login',
  logoutURL: '/logout'
});

const ssoConfig = sso.prepareToSend();

// Use with API calls on the server
const publicApi = new PublicApi();
const response = await publicApi.getCommentsPublic({
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id',
  sso: JSON.stringify(ssoConfig)
});

// Or send ssoConfig to client for browser usage

Коришћење SSO из прегледача (са серверски генерисаним токеном)

// Client-side code (browser)
import { PublicApi } from 'fastcomments-sdk/browser';

// Get SSO token from your server endpoint
const ssoToken = await fetch('/api/sso-token').then(r => r.json());

const publicApi = new PublicApi();
const response = await publicApi.getCommentsPublic({
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id',
  sso: ssoToken // Use the server-generated SSO token
});

SSO са креирањем коментара

// Server-side: Create SSO and comment
import { FastCommentsSSO, PublicApi } from 'fastcomments-sdk/server';

const sso = FastCommentsSSO.createSecure('your-api-key', userData);
const ssoConfig = sso.prepareToSend();

const response = await publicApi.createCommentPublic({
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id',
  broadcastId: 'unique-broadcast-id',
  commentData: {
    comment: 'This is my comment',
    date: Date.now(),
    commenterName: 'John Doe',
    url: 'https://example.com/page',
    urlId: 'page-url-id'
  },
  sso: JSON.stringify(ssoConfig)
});

Чести случајеви употребе

Dobijanje komentara za stranicu

const comments = await sdk.publicApi.getCommentsPublic({
  tenantId: 'your-tenant-id',
  urlId: 'article-123'
});

Kreiranje komentara

const newComment = await sdk.publicApi.createCommentPublic({
  createCommentParams: {
    tenantId: 'your-tenant-id',
    urlId: 'article-123',
    comment: 'Great article!',
    commenterName: 'John Doe',
    commenterEmail: 'john@example.com'
  }
});

Glasanje za komentar

const voteResponse = await sdk.publicApi.voteComment({
  voteBodyParams: {
    commentId: 'comment-id',
    direction: 1 // 1 za podršku, -1 za protiv
  }
});

Upravljanje korisnicima (zahteva API ključ)

// Pretraži korisnike (zahteva DefaultApi)
const users = await sdk.defaultApi.searchUsers({
  tenantId: 'your-tenant-id',
  urlId: 'page-id',
  usernameStartsWith: 'john'
});

Догађаји уживо (ажурирања у реалном времену)

Претплатите се на догађаје уживо да бисте добијали ажурирања у реалном времену за коментаре, гласове и друге активности.

Догађаји на нивоу странице

Слушајте догађаје уживо за одређену страницу (коментари, гласови итд.):

import { subscribeToChanges, LiveEvent, LiveEventType } from 'fastcomments-sdk/browser';

const config = {
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id',
};

// Претплатите се на догађаје уживо за страницу
const subscription = subscribeToChanges(
  config,
  'your-tenant-id', // tenantIdWS
  'page-url-id',    // urlIdWS  
  'user-session-id', // userIdWS (преузмите ово из одговора getComments)
  (event: LiveEvent) => {
    console.log('Live event received:', event);

    switch (event.type) {
      case LiveEventType.new_comment:
        console.log('New comment:', event.comment);
        // Ажурирајте ваш кориснички интерфејс са новим коментаром
        break;
      case LiveEventType.new_vote:
        console.log('New vote:', event.vote);
        // Ажурирајте број гласова у вашем корисничком интерфејсу
        break;
      case LiveEventType.updated_comment:
        console.log('Comment updated:', event.comment);
        break;
      default:
        console.log('Other event type:', event.type);
    }

    return true; // Return true if event was handled
  },
  (isConnected: boolean) => {
    console.log('Connection status:', isConnected ? 'Connected' : 'Disconnected');
  }
);

// Затворите претплату када завршите
subscription.close();

Претплата на корисничке догађаје

Слушајте догађaje специфичне за корисника (обавештења, помињања итд.):

import { subscribeToUserFeed, LiveEvent, LiveEventType } from 'fastcomments-sdk/browser';

const userConfig = {
  userIdWS: 'user-session-id', // Преузмите ово из одговора getComments
};

// Претплатите се на лични фид корисника
const userSubscription = subscribeToUserFeed(
  userConfig,
  (event: LiveEvent) => {
    console.log('User event received:', event);

    switch (event.type) {
      case LiveEventType.notification:
        console.log('New notification:', event.notification);
        // Прикажите обавештење у вашем корисничком интерфејсу
        break;
      case LiveEventType.notification_update:
        console.log('Notification updated:', event.notification);
        break;
      default:
        console.log('Other user event:', event.type);
    }

    return true;
  },
  (isConnected: boolean) => {
    console.log('User feed connection:', isConnected ? 'Connected' : 'Disconnected');
  }
);

// Затворите када завршите
userSubscription.close();

Добијање userIdWS

Параметар userIdWS је обавезан за догађаје уживо и може се добити из одговора API-ја:

const response = await sdk.publicApi.getCommentsPublic({
  tenantId: 'your-tenant-id',
  urlId: 'page-id'
});

// Извуците userIdWS из одговора
const userIdWS = response.data?.userSessionInfo?.userIdWS;

if (userIdWS) {
  // Сада се можете претплатити на догађаје уживо
  const subscription = subscribeToChanges(config, tenantIdWS, urlIdWS, userIdWS, handleEvent);
}

Идентификатори емитовања

Видећете да треба да проследите broadcastId у неким API позивима. Када примите догађаје, добићете овај ID назад, па ћете знати да игноришете догађај ако планирате да оптимистички примените промене на клијенту (што ћете вероватно желети, јер пружа најбоље корисничко искуство). Проследите UUID овде. ID треба да буде довољно јединствен да се не појави два пута у прегледачкој сесији.

import { v4 as uuidv4 } from 'uuid';

const response = await sdk.publicApi.createCommentPublic({
  createCommentParams: {
    tenantId: 'your-tenant-id',
    urlId: 'page-id',
    comment: 'My comment',
    broadcastId: uuidv4() // Јединствени ID за ову операцију
  }
});

Обрада грешака

try {
  const comments = await sdk.publicApi.getCommentsPublic({
    tenantId: 'your-tenant-id',
    urlId: 'page-id'
  });
} catch (error) {
  if (error.response?.status === 404) {
    console.log('Page not found');
  } else {
    console.error('API Error:', error.message);
  }
}

aggregate

Agregira dokumente grupišući ih (ako je groupBy naveden) i primjenjujući više operacija. Podržane su različite operacije (npr. sum, countDistinct, avg itd.).

Parametri

Name	Type	Required
tenantId	string	Da
aggregationRequest	AggregationRequest	Da
parentTenantId	string	Ne
includeStats	boolean	Ne

Odgovor

Vraća: AggregationResponse

getAuditLogs

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
limit	number	Не
skip	number	Не
order	SORTDIR	Не
after	number	Не
before	number	Не

Одговор

Враћа: GetAuditLogs200Response

Пример

getAuditLogs Пример

Copy

async function main(): Promise<void> {
  const tenantId: string = 'tenant_9b8f6c';
  const limit: number = 50;
  const skip: number = 0;
  const order: SORTDIR = 'desc';
  const after: number = Date.now() - 7 * 24 * 60 * 60 * 1000;
  const response: GetAuditLogs200Response = await getAuditLogs(tenantId, limit, skip, order, after);
  console.log(response);
}
main();

blockFromCommentPublic

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
commentId	string	Да
publicBlockFromCommentParams	PublicBlockFromCommentParams	Да
sso	string	Не

Одговор

Враћа: BlockFromCommentPublic200Response

Пример

Пример blockFromCommentPublic

Copy

const tenantId: string = "site_7f9b2e";
const commentId: string = "comment_2026-03-25_001";
const publicBlockFromCommentParams: PublicBlockFromCommentParams = {
  reason: "Repeated harassment and targeted abuse",
  blockDurationDays: 90,
  includeHistory: true,
  notifyModeratorTeam: true
};
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.fakePayload.signature";
const result: BlockFromCommentPublic200Response = await blockFromCommentPublic(tenantId, commentId, publicBlockFromCommentParams, sso);

unBlockCommentPublic

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
commentId	string	Да
publicBlockFromCommentParams	PublicBlockFromCommentParams	Да
sso	string	Не

Одговор

Враћа: UnBlockCommentPublic200Response

Пример

Пример unBlockCommentPublic

Copy

const tenantId: string = 'tenant_42e8a1';
const commentId: string = 'cmt_9b3f2d';
const publicBlockFromCommentParams: PublicBlockFromCommentParams = {
  reason: 'abusive_language',
  blockedByModeratorId: 'mod_17',
  note: 'Targeted harassment; review complete',
  unblockRequestedAt: new Date().toISOString()
};
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example.signature';
const result: UnBlockCommentPublic200Response = await unBlockCommentPublic(tenantId, commentId, publicBlockFromCommentParams, sso);

checkedCommentsForBlocked

Параметри

Name	Type	Required
tenantId	string	Да
commentIds	string	Да
sso	string	Не

Одговор

Враћа: CheckedCommentsForBlocked200Response

Пример

checkedCommentsForBlocked Пример

Copy

const tenantId: string = 'tenant_4f3b2a1e';
const commentIds: string = 'c_1001,c_1002,c_1003';
const ssoToken: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyMTIzIn0.Sf4ke7nQP3mZx9v2';
const resultWithoutSSO: CheckedCommentsForBlocked200Response = await checkedCommentsForBlocked(tenantId, commentIds);
const resultWithSSO: CheckedCommentsForBlocked200Response = await checkedCommentsForBlocked(tenantId, commentIds, ssoToken);

blockUserFromComment

Параметри

Name	Type	Required
tenantId	string	Да
id	string	Да
blockFromCommentParams	BlockFromCommentParams	Да
userId	string	Не
anonUserId	string	Не

Response

Враћа: BlockFromCommentPublic200Response

Пример

Пример blockUserFromComment

Copy

const tenantId: string = "tenant_12345";
const id: string = "comment_67890";
const blockFromCommentParams: BlockFromCommentParams = {
  reason: "Repeated abusive language",
  blockDurationHours: 168,
  blockReplies: true,
  notifyAuthor: true
};
const userId: string = "user_abc123";
const anonUserId: string = "anon_xyz789";
const result: BlockFromCommentPublic200Response = await blockUserFromComment(tenantId, id, blockFromCommentParams, userId, anonUserId);

createCommentPublic

Параметри

Име	Тип	Обавезно
tenantId	string	Да
urlId	string	Да
broadcastId	string	Да
commentData	CommentData	Да
sessionId	string	Не
sso	string	Не

Одговор

Враћа: CreateCommentPublic200Response

Пример

createCommentPublic Пример

Copy

const tenantId: string = 'tenant_prod_42';
const urlId: string = 'article-2026-03-25-tech-deep-dive';
const broadcastId: string = 'live-broadcast-001';
const sessionId: string = 'sess_9f8e7d6a3b';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example.signature';
const commentData: CommentData = {
  content: 'Great reporting — appreciated the depth on performance tradeoffs.',
  authorName: 'Jordan M.',
  language: 'en-US',
  metadata: { client: 'web' }
};
const result: CreateCommentPublic200Response = await createCommentPublic(tenantId, urlId, broadcastId, commentData, sessionId, sso);

deleteComment

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
contextUserId	string	Ne
isLive	boolean	Ne

Odgovor

Vraća: DeleteComment200Response

Primjer

Primjer deleteComment

Copy

const tenantId: string = 'tenant_7b3f2a';
const commentId: string = 'cmt_8a1f4d2b';
const contextUserId: string = 'user_102';
const isLive: boolean = true;
const result: DeleteComment200Response = await deleteComment(tenantId, commentId, contextUserId, isLive);

deleteCommentPublic

Параметри

Име	Тип	Обавезно
tenantId	string	Да
commentId	string	Да
broadcastId	string	Да
editKey	string	Не
sso	string	Не

Одговор

Враћа: DeleteCommentPublic200Response

Пример

deleteCommentPublic Пример

Copy

const tenantId: string = 'tenant_4f2c9b';
const commentId: string = 'comment-7c3a9f2d';
const broadcastId: string = 'article-2026-03-20';
const editKey: string | undefined = 'ek_pub_abc12345';
const sso: string | undefined = 'sso_eyJhbGciOiJIUzI1Ni';
const result: DeleteCommentPublic200Response = await deleteCommentPublic(
  tenantId,
  commentId,
  broadcastId,
  editKey,
  sso
);

deleteCommentVote

Параметри

Име	Тип	Обавезно
tenantId	string	Да
commentId	string	Да
voteId	string	Да
urlId	string	Да
broadcastId	string	Да
editKey	string	Не
sso	string	Не

Одговор

Враћа: DeleteCommentVote200Response

Пример

Пример за deleteCommentVote

Copy

const tenantId: string = 'acme-tenant-87e4fd';
const commentId: string = 'cmt-9a12b3f4';
const voteId: string = 'vote-4f6d21b9';
const urlId: string = 'https://www.acme.com/articles/2026/03/25/how-to-test';
const broadcastId: string = 'broadcast-20260325-01';
const editKey: string = 'editkey-6b7c8d9e';
const sso: string = 'sso-jwt-eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9';
const response: DeleteCommentVote200Response = await deleteCommentVote(
  tenantId,
  commentId,
  voteId,
  urlId,
  broadcastId,
  editKey,
  sso
);

flagComment

Параметри

Назив	Type	Потребно
tenantId	string	Да
id	string	Да
userId	string	Не
anonUserId	string	Не

Одговор

Враћа: FlagComment200Response

Пример

flagComment Пример

Copy

const tenantId: string = 'tenant_acme_001';
const id: string = 'comment_7f3a2b9e';
const userId: string = 'user_jdoe_1001';
const anonUserId: string = 'anon_3f2b_visitor';
const result: FlagComment200Response = await flagComment(tenantId, id, userId, anonUserId);

getComment

Параметри

Name	Type	Required	Description
tenantId	string	Yes
id	string	Yes

Одговор

Враћа: GetComment200Response

Пример

getComment Пример

Copy

const tenantId: string = "acme-publishing-001";
const commentId: string = "f3b2c1d0-9a8e-4b7c-8123-6d5f0a1e2b3c";
const result: GetComment200Response = await getComment(tenantId, commentId);
const wrapper: GetComment200Response & { comment?: APIComment } = result;
const comment: APIComment | undefined = wrapper.comment;
const authorBadge: CommentUserBadgeInfo | undefined = comment?.user?.badge;
const userHashTags: CommentUserHashTagInfo[] | undefined = comment?.user?.hashTags

getComments

Параметри

Име	Тип	Обавезно
tenantId	string	Да
page	number	Не
limit	number	Не
skip	number	Не
asTree	boolean	Не
skipChildren	number	Не
limitChildren	number	Не
maxTreeDepth	number	Не
urlId	string	Не
userId	string	Не
anonUserId	string	Не
contextUserId	string	Не
hashTag	string	Не
parentId	string	Не
direction	SortDirections	Не

Одговор

Враћа: GetComments200Response

Пример

getComments Пример

Copy

const tenantId: string = 'tenant_acme_42';
const response: GetComments200Response = await getComments(
  tenantId,
  1, // страница
  20, // ограничење
  0, // прескочи
  true, // као дрво
  1, // прескочи децу
  3, // ограничење за децу
  4, // максимална дубина дрвета
  'articles/2026/new-product-launch', // ид URL-а
  'user_7890', // ид корисника
  'anon_4f3b2', // ид анонимног корисника
  undefined, // ид корисника у контексту
  '#launch', // хаштага
  undefined // ид родитеља
);

getCommentsPublic

req tenantId urlId

Параметри

Име	Тип	Обавезно
tenantId	string	Да
urlId	string	Да
page	number	Не
direction	SortDirections	Не
sso	string	Не
skip	number	Не
skipChildren	number	Не
limit	number	Не
limitChildren	number	Не
countChildren	boolean	Не
fetchPageForCommentId	string	Не
includeConfig	boolean	Не
countAll	boolean	Не
includei10n	boolean	Не
locale	string	Не
modules	string	Не
isCrawler	boolean	Не
includeNotificationCount	boolean	Не
asTree	boolean	Не
maxTreeDepth	number	Не
useFullTranslationIds	boolean	Не
parentId	string	Не
searchText	string	Не
hashTags	Array	Не
userId	string	Не
customConfigStr	string	Не
afterCommentId	string	Не
beforeCommentId	string	Не

Одговор

Враћа: GetCommentsPublic200Response

Пример

getCommentsPublic Примјер

Copy

const tenantId: string = 'tenant_eu-west_01';
const urlId: string = 'https://www.financialtimes.com/articles/2026/market-update-q1';
const response: GetCommentsPublic200Response = await getCommentsPublic(
  tenantId,
  urlId,
  2,
  undefined,
  'eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.tokenPayload.signature',
  undefined,
  0,
  50,
  5,
  true,
  undefined,
  true,
  false,
  true,
  'en-US',
  'reactions,moderation',
  false,
  true,
  true,
  3,
  false,
  undefined,
  'performance',
  ['feature','fastcomments'],
  'user_9876',
  undefined,
  undefined,
  undefined
);

getCommentText

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
commentId	string	Да
editKey	string	Не
sso	string	Не

Одговор

Враћа: GetCommentText200Response

Пример

getCommentText Пример

Copy

const tenantId: string = 'tenant_acme_001';
const commentId: string = 'cmt_7890b';
const editKey: string = 'edit_4f2d9b7c';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9';
const result: GetCommentText200Response = await getCommentText(tenantId, commentId, editKey, sso);

getCommentVoteUserNames

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
commentId	string	Da
dir	number	Da
sso	string	Ne

Odgovor

Vraća: GetCommentVoteUserNames200Response

Primer

getCommentVoteUserNames Primer

Copy

(async () => {
  const tenantId: string = 'tenant_4f2c1e';
  const commentId: string = 'cmt_9a7b3d';
  const dir: number = 1;
  const resultUpvotes: GetCommentVoteUserNames200Response = await getCommentVoteUserNames(tenantId, commentId, dir);
  const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.fakepayload.signature';
  const dirDown: number = -1;
  const resultDownvotes: GetCommentVoteUserNames200Response = await getCommentVoteUserNames(tenantId, commentId, dirDown, sso);
  console.log(resultUpvotes, resultDownvotes);
})();

lockComment

Параметри

Име	Тип	Обавезно
tenantId	string	Да
commentId	string	Да
broadcastId	string	Да
sso	string	Не

Одговор

Враћа: LockComment200Response

Пример

Пример lockComment

Copy

const tenantId: string = "tenant_prod_8f3a2b";
const commentId: string = "cmt_5d7e9a92";
const broadcastId: string = "broadcast_2026_03_25_1400";
const ssoToken: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example.signature";
const resultWithSso: LockComment200Response = await lockComment(tenantId, commentId, broadcastId, ssoToken);
const resultWithoutSso: LockComment200Response = await lockComment(tenantId, commentId, broadcastId);

pinComment

Параметри

Име	Тип	Обавезно
tenantId	string	Да
commentId	string	Да
broadcastId	string	Да
sso	string	Не

Одговор

Враћа: PinComment200Response

Пример

pinComment Пример

Copy

const tenantId: string = "tenant_4f2b9a";
const commentId: string = "cmt_9f8e7d6c";
const broadcastId: string = "brd_live_concert_2026-03-25";
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.sso_payload_signature";
const result: PinComment200Response = await pinComment(tenantId, commentId, broadcastId, sso);

saveComment

Параметри

Име	Тип	Обавезно
tenantId	string	Да
createCommentParams	CreateCommentParams	Да
isLive	boolean	Не
doSpamCheck	boolean	Не
sendEmails	boolean	Не
populateNotifications	boolean	Не

Одговор

Враћа: SaveComment200Response

Пример

saveComment Пример

Copy

const tenantId: string = 'tenant_acme_001';
const createCommentParams: CreateCommentParams = {
  content: 'Great article — helped me fix a production issue in minutes.',
  url: 'https://app.acme.com/blog/performance-tips',
  author: { name: 'Maya Chen', email: 'maya.chen@acme.com' },
  metadata: { locale: 'en-US', appVersion: '4.2.1' }
} as CreateCommentParams;
const isLive: boolean = true;
const doSpamCheck: boolean = true;
const sendEmails: boolean = false;
const populateNotifications: boolean = true;
const result: SaveComment200Response = await saveComment(tenantId, createCommentParams, isLive, doSpamCheck, sendEmails, populateNotifications);

saveCommentsBulk

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
createCommentParams	Array	Da
isLive	boolean	Ne
doSpamCheck	boolean	Ne
sendEmails	boolean	Ne
populateNotifications	boolean	Ne

Odgovor

Vraća: Array<SaveComment200Response

Primjer

saveCommentsBulk Primjer

Copy

const tenantId: string = 'acme-corp-01';
const mentions1: CommentUserMentionInfo[] = [{ userId: 'user-123', displayName: 'Jane Doe' }];
const hashtags1: CommentUserHashTagInfo[] = [{ tag: 'typescript' }];
const createCommentParams: CreateCommentParams[] = [
  {
    content: 'Great insights on async/await patterns.',
    authorName: 'John Smith',
    authorEmail: 'john.smith@acme.com',
    externalId: 'comment-001',
    createdAt: '2026-03-25T10:15:00Z',
    userMentions: mentions1,
    userHashTags: hashtags1
  },
  {
    content: 'I prefer using Promise.all for bulk ops.',
    authorName: 'Emily Turner',
    authorEmail: 'emily.turner@acme.com',
    externalId: 'comment-002',
    createdAt: '2026-03-25T10:20:00Z'
  }
];
const result: SaveComment200Response[] = await saveCommentsBulk(tenantId, createCommentParams, true, true, false, true);

setCommentText

Параметри

Име	Тип	Обавезно
tenantId	string	Да
commentId	string	Да
broadcastId	string	Да
commentTextUpdateRequest	CommentTextUpdateRequest	Да
editKey	string	Не
sso	string	Не

Одговор

Враћа: SetCommentText200Response

Пример

setCommentText Пример

Copy

const tenantId: string = 'tenant_6721f4';
const commentId: string = 'cmt_9a3b2d';
const broadcastId: string = 'live_2026_03_25';
const editKey: string = 'edit_k_4f7b9';
const sso: string = 'sso_tok_eyJhbGciOiJIUzI1';
const commentTextUpdateRequest: CommentTextUpdateRequest = {
  text: 'Updated to clarify the timeline and link the relevant docs.',
  mentions: [{ userId: 'user_102', displayName: 'Alex Rivera' }],
  hashtags: [{ tag: 'product-update' }]
};
const result: SetCommentText200Response = await setCommentText(tenantId, commentId, broadcastId, commentTextUpdateRequest, editKey, sso);

unBlockUserFromComment

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
unBlockFromCommentParams	UnBlockFromCommentParams	Da
userId	string	Ne
anonUserId	string	Ne

Odgovor

Vraća: UnBlockCommentPublic200Response

Primjer

Primjer unBlockUserFromComment

Copy

const tenantId: string = 'tenant_87f3e1';
const id: string = 'comment_9b2a4f';
const unBlockFromCommentParams: UnBlockFromCommentParams = {
  reason: 'Reviewed by moderation team — reinstated',
  moderatorId: 'mod_21',
  unblockedAt: new Date().toISOString()
};
const userId: string = 'user_42';
const anonUserId: string = 'anon_e7f9';
const result: UnBlockCommentPublic200Response = await unBlockUserFromComment(tenantId, id, unBlockFromCommentParams, userId, anonUserId);

unFlagComment

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
id	string	Да
userId	string	Не
anonUserId	string	Не

Одговор

Враћа: FlagComment200Response

Пример

Пример unFlagComment

Copy

const tenantId: string = 'acme-tenant-001';
const commentId: string = 'cmt_9f8e7d6c';
const userId: string = 'user_72b4a1c9';
const anonUserId: string = 'anon_3d2c1b0a';
const response: FlagComment200Response = await unFlagComment(tenantId, commentId, userId, anonUserId);

unLockComment

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
commentId	string	Да
broadcastId	string	Да
sso	string	Не

Одговор

Враћа: LockComment200Response

Пример

Пример unLockComment

Copy

const tenantId: string = 'tenant_9d4f2b';
const commentId: string = 'cmt_8a3e1f';
const broadcastId: string = 'broadcast_2026_03_25';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example.signature';
const result: LockComment200Response = await unLockComment(tenantId, commentId, broadcastId, sso);

unPinComment

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
commentId	string	Da
broadcastId	string	Da
sso	string	Ne

Odgovor

Vraća: PinComment200Response

Primjer

unPinComment Primjer

Copy

const tenantId: string = 'tenant_7f9d2a3b';
const commentId: string = 'comment_842b9c1f';
const broadcastId: string = 'bcast_frontpage_202603';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.exampleSignature';
const result: PinComment200Response = await unPinComment(tenantId, commentId, broadcastId, sso);

updateComment

Параметри

Name	Type	Required
tenantId	string	Да
id	string	Да
updatableCommentParams	UpdatableCommentParams	Да
contextUserId	string	Не
doSpamCheck	boolean	Не
isLive	boolean	Не

Одговор

Враћа: FlagCommentPublic200Response

Пример

Пример updateComment

Copy

const tenantId: string = "tenant_acme_corp_01";
const id: string = "comment_20260325_4592";
const updatableCommentParams: UpdatableCommentParams = {
  body: "Updated the response to include a link to the RFC and fixed a typo in the second paragraph.",
  editedByUserId: "user_8721",
  isVisible: true
};
const contextUserId: string = "user_8721";
const doSpamCheck: boolean = true;
const isLive: boolean = true;
const result: FlagCommentPublic200Response = await updateComment(tenantId, id, updatableCommentParams, contextUserId, doSpamCheck, isLive);

voteComment

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
commentId	string	Да
urlId	string	Да
broadcastId	string	Да
voteBodyParams	VoteBodyParams	Да
sessionId	string	Не
sso	string	Не

Одговор

Враћа: VoteComment200Response

Пример

voteComment Пример

Copy

const tenantId: string = 'tenant_9f8b7c';
const commentId: string = 'cmt_42f3a1';
const urlId: string = 'articles/ai-trends-2026';
const broadcastId: string = 'web';
const voteBodyParams: VoteBodyParams = { vote: 1, reason: 'Insightful and on-topic' };
const sessionId: string = 'sess_6d2b4c9e';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9';
const result: VoteComment200Response = await voteComment(tenantId, commentId, urlId, broadcastId, voteBodyParams, sessionId, sso);

addDomainConfig

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
addDomainConfigParams	AddDomainConfigParams	Da

Odgovor

Vraća: AddDomainConfig200Response

deleteDomainConfig

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
domain	string	Да

Одговор

Враћа: DeleteDomainConfig200Response

getDomainConfig

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
domain	string	Да

Одговор

Враћа: GetDomainConfig200Response

getDomainConfigs

Parametri

Ime	Tip	Obavezno	Opis
tenantId	string	Da

Odgovor

Vraća: GetDomainConfigs200Response

patchDomainConfig

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
domainToUpdate	string	Da
patchDomainConfigParams	PatchDomainConfigParams	Da

Odgovor

Vraća: GetDomainConfig200Response

putDomainConfig

Параметри

Име	Тип	Обавезно
tenantId	string	Да
domainToUpdate	string	Да
updateDomainConfigParams	UpdateDomainConfigParams	Да

Одговор

Враћа: GetDomainConfig200Response

createEmailTemplate

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Yes
createEmailTemplateBody	CreateEmailTemplateBody	Yes

Одговор

Враћа: CreateEmailTemplate200Response

Пример

createEmailTemplate Пример

Copy

const tenantId: string = "tenant_7a9f3c2b";
const customConfig: CustomConfigParameters = { smtpHost: "smtp.fastmail.com", smtpPort: 587, useTLS: true };
const createEmailTemplateBody: CreateEmailTemplateBody = {
  name: "Account Notification",
  subject: "Your ACME account was updated",
  fromEmail: "no-reply@acme-corp.com",
  replyTo: "support@acme-corp.com",
  html: "<p>Hi {{user.firstName}}, your account settings were changed.</p>",
  text: "Hi {{user.firstName}}, your account settings were changed.",
  isActive: true,
  description: "Used for transactional account update emails",
  customConfig
};
const result: CreateEmailTemplate200Response = await createEmailTemplate(tenantId, createEmailTemplateBody);

deleteEmailTemplate

Параметри

Назив	Тип	Обавезно	Опис
tenantId	string	Да
id	string	Да

Одговор

Враћа: FlagCommentPublic200Response

Примјер

deleteEmailTemplate Примјер

Copy

const tenantId: string = 'tenant_7f4c9d1e';
const templateId: string = 'tmpl_welcome_2024-03';
const notifyAdmin: boolean | undefined = true; // примјер опционалног параметра
const result: FlagCommentPublic200Response = await deleteEmailTemplate(tenantId, templateId);

deleteEmailTemplateRenderError

Параметри

Име	Тип	Потребно
tenantId	string	Да
id	string	Да
errorId	string	Да

Одговор

Враћа: FlagCommentPublic200Response

Пример

deleteEmailTemplateRenderError Пример

Copy

const tenantId: string = 'tenant_7f3b4c2a';
const templateEnvironment: string | undefined = 'production'; // опциони селектор окружења
const id: string = `emailTemplates/${templateEnvironment ?? 'staging'}/welcome_v2`;
const errorId: string = 'err_5a9d2f1c';
const result: FlagCommentPublic200Response = await deleteEmailTemplateRenderError(tenantId, id, errorId);
console.log(result);

getEmailTemplate

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetEmailTemplate200Response

Primjer

getEmailTemplate Primjer

Copy

const tenantId: string = "acme-marketing-042";
const templateId: string = "tpl_welcome_2026";
const result: GetEmailTemplate200Response = await getEmailTemplate(tenantId, templateId);
const template: CustomEmailTemplate | undefined = result.template;
const subject: string | undefined = template?.subject;
const customParams: CustomConfigParameters | undefined = template?.customConfigParameters;

getEmailTemplateDefinitions

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da

Odgovor

Vraća: GetEmailTemplateDefinitions200Response

Primjer

getEmailTemplateDefinitions Primjer

Copy

const tenantId: string = 'tenant_acme_eu_01';
const templates: GetEmailTemplateDefinitions200Response = await getEmailTemplateDefinitions(tenantId);
console.log('Email template definitions loaded for', tenantId, templates);

getEmailTemplateRenderErrors

Параметри

Име	Тип	Обавезно
tenantId	string	Да
id	string	Да
skip	number	Не

Одговор

Враћа: GetEmailTemplateRenderErrors200Response

Пример

Пример за getEmailTemplateRenderErrors

Copy

(async () => {
  const tenantId: string = 'acme-tenant-42';
  const id: string = 'tmpl_3fa85f64-5717-4562-b3fc-2c963f66afa6';
  const skip: number = 20;
  const result: GetEmailTemplateRenderErrors200Response = await getEmailTemplateRenderErrors(tenantId, id, skip);
  console.log(result);
})();

getEmailTemplates

Параметри

Назив	Тип	Обавезно	Опис
tenantId	string	Да
skip	number	Не

Одговор

Враћа: GetEmailTemplates200Response

Примјер

Примјер getEmailTemplates

Copy

async function main(): Promise<void> {
  const tenantId: string = 'tenant_5f3a9c2b';
  const templates: GetEmailTemplates200Response = await getEmailTemplates(tenantId);
  const skip: number = 20;
  const pagedTemplates: GetEmailTemplates200Response = await getEmailTemplates(tenantId, skip);
  console.log(templates, pagedTemplates);
}
main();

renderEmailTemplate

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
renderEmailTemplateBody	RenderEmailTemplateBody	Да
locale	string	Не

Одговор

Враћа: RenderEmailTemplate200Response

Пример

renderEmailTemplate Пример

Copy

const tenantId: string = 'tenant_b6f3c2';
const renderEmailTemplateBody: RenderEmailTemplateBody = {
  templateId: 'comment-notification',
  recipient: { name: 'Ava Thompson', email: 'ava.thompson@publisher.com' },
  context: {
    siteName: 'City Gazette',
    commentText: 'Thanks for the in-depth coverage — very helpful.',
    articleTitle: 'Downtown Redevelopment Plan Advances',
    threadUrl: 'https://citygazette.example/articles/2026/redevelopment#comments'
  }
};
const locale: string = 'en-US';
const result: RenderEmailTemplate200Response = await renderEmailTemplate(tenantId, renderEmailTemplateBody, locale);

updateEmailTemplate

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
id	string	Да
updateEmailTemplateBody	UpdateEmailTemplateBody	Да

Одговор

Враћа: FlagCommentPublic200Response

Пример

Пример updateEmailTemplate

Copy

const tenantId: string = "tenant_76a4b2";
const id: string = "template_9f3c1e";
const updateEmailTemplateBody: UpdateEmailTemplateBody = {
  name: "Comment Flag Notification",
  subject: "A comment was flagged on your-site.com",
  bodyHtml: "<p>Admin,</p><p>User {{commenterName}} flagged a comment: “{{commentText}}”</p>",
  isEnabled: true,
  description: "Email sent to moderators when a comment is flagged (optional field included)"
};
const result: FlagCommentPublic200Response = await updateEmailTemplate(tenantId, id, updateEmailTemplateBody);

getEventLog

req tenantId urlId userIdWS

Параметри

Name	Type	Required
tenantId	string	Да
urlId	string	Да
userIdWS	string	Да
startTime	number	Да
endTime	number	Да

Одговор

Враћа: GetEventLog200Response

Пример

getEventLog Пример

Copy

const tenantId: string = 'fastcomments-tenant-01';
const urlId: string = 'article-2026-03-25';
const userIdWS: string | undefined = undefined; // опциона upstream вредност
const startTime: number = Date.parse('2026-03-01T00:00:00Z');
const endTime: number = Date.parse('2026-03-25T23:59:59Z');
const eventLogResponse: GetEventLog200Response = await getEventLog(
  tenantId,
  urlId,
  userIdWS ?? 'ws_user_8b1f',
  startTime,
  endTime
);

getGlobalEventLog

req tenantId urlId userIdWS

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
urlId	string	Да
userIdWS	string	Да
startTime	number	Да
endTime	number	Да

Одговор

Враћа: GetEventLog200Response

Пример

getGlobalEventLog Пример

Copy

const tenantId: string = "tenant-84b2f1";
const urlId: string = "article-6721";
const userIdWS: string = "ws-conn-9a3c";
const startTime: number = Date.now() - 7 * 24 * 60 * 60 * 1000; // пре 7 дана
const endTimeOptional: number | undefined = undefined; // опционални крај временског опсега
const endTime: number = endTimeOptional ?? Date.now();
const eventLog: GetEventLog200Response = await getGlobalEventLog(tenantId, urlId, userIdWS, startTime, endTime);

createFeedPost

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
createFeedPostParams	CreateFeedPostParams	Da
broadcastId	string	Ne
isLive	boolean	Ne
doSpamCheck	boolean	Ne
skipDupCheck	boolean	Ne

Odgovor

Vraća: CreateFeedPost200Response

Primjer

Primjer createFeedPost

Copy

const tenantId: string = "tenant_7f3b9a";
const createFeedPostParams: CreateFeedPostParams = {
  title: "Weekly Product Update — March 2026",
  body: "We've shipped performance improvements and bug fixes across the web client. See the release notes for details.",
  authorId: "user_86fa2b",
  allowComments: true,
  media: [
    {
      url: "https://cdn.example.com/images/update-march.png",
      mimeType: "image/png",
      caption: "Performance graph",
      assets: [{ url: "https://cdn.example.com/images/update-march@2x.png", width: 1600, height: 900 }]
    }
  ],
  links: [{ url: "https://www.example.com/release-notes/march-2026", title: "Release notes" }]
};
const broadcastId: string = "broadcast_prod_updates_202603";
const isLive: boolean = false;
const doSpamCheck: boolean = true;
const skipDupCheck: boolean = false;
const result: CreateFeedPost200Response = await createFeedPost(tenantId, createFeedPostParams, broadcastId, isLive, doSpamCheck, skipDupCheck);

createFeedPostPublic

Parametri

Ime	Tip	Obavezno
tenantId	string	Da
createFeedPostParams	CreateFeedPostParams	Da
broadcastId	string	Ne
sso	string	Ne

Odgovor

Vraća: CreateFeedPostPublic200Response

Primjer

Primjer createFeedPostPublic

Copy

const tenantId: string = "tenant_987654321";
const asset: FeedPostMediaItemAsset = { url: "https://cdn.fastcomments.com/uploads/team-photo.jpg", mimeType: "image/jpeg", sizeBytes: 324512 };
const mediaItem: FeedPostMediaItem = { type: "image", assets: [asset], caption: "Team launch day" };
const link: FeedPostLink = { url: "https://www.example.com/blog/product-update-march-2026", title: "Product update — March 2026" };
const createFeedPostParams: CreateFeedPostParams = {
  title: "Product update — March 2026",
  content: "<p>We shipped performance improvements and two new integrations.</p>",
  media: [mediaItem],
  link,
  visibility: "public",
  tags: ["product","release","march-2026"],
  customConfig: { allowComments: true, requireTOS: false }
};
const broadcastId: string = "broadcast_2026_03_25_live";
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiIxMjM0NSIsImlhdCI6MTY5MDI0MDB9.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c";
const result: CreateFeedPostPublic200Response = await createFeedPostPublic(tenantId, createFeedPostParams, broadcastId, sso);

deleteFeedPostPublic

Параметри

Име	Тип	Обавезно
tenantId	string	Да
postId	string	Да
broadcastId	string	Не
sso	string	Не

Одговор

Враћа: DeleteFeedPostPublic200Response

Пример

deleteFeedPostPublic Пример

Copy

const tenantId: string = "tenant_5f8a9b3c";
const postId: string = "post_a1b2c3d4";
const broadcastId: string = "broadcast_2026-03-25T10:00:00Z";
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyMTIzIiwiaWF0IjoxNjE5MjM5MjAwfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c";
const resultWithOptional: DeleteFeedPostPublic200Response = await deleteFeedPostPublic(tenantId, postId, broadcastId, sso);
const resultRequiredOnly: DeleteFeedPostPublic200Response = await deleteFeedPostPublic(tenantId, postId);

getFeedPosts

req tenantId afterId

Параметри

Име	Тип	Обавезно
tenantId	string	Да
afterId	string	Не
limit	number	Не
tags	Array	Не

Одговор

Враћа: GetFeedPosts200Response

Пример

Пример за getFeedPosts

Copy

const initialPage: GetFeedPosts200Response = await getFeedPosts('tenant_9f1b3d', undefined, 20, ['sports', 'local']);
const nextPage: GetFeedPosts200Response = await getFeedPosts('tenant_9f1b3d', 'post_abc123', 20, ['sports', 'local']);

getFeedPostsPublic

req tenantId afterId

Параметри

Name	Type	Required
tenantId	string	Да
afterId	string	Не
limit	number	Не
tags	Array	Не
sso	string	Не
isCrawler	boolean	Не
includeUserInfo	boolean	Не

Одговор

Враћа: GetFeedPostsPublic200Response

Пример

getFeedPostsPublic Пример

Copy

const tenantId: string = 'tenant_acme_01';
const afterId: string = 'fp_20260301_042';
const limit: number = 25;
const tags: Array<string> = ['technology', 'announcement'];
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjoiamRvZSJ9.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
const isCrawler: boolean = false;
const includeUserInfo: boolean = true;
const response: GetFeedPostsPublic200Response = await getFeedPostsPublic(tenantId, afterId, limit, tags, sso, isCrawler, includeUserInfo);

getFeedPostsStats

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
postIds	Array	Да
sso	string	Не

Одговор

Враћа: GetFeedPostsStats200Response

Пример

Пример getFeedPostsStats

Copy

const tenantId: string = 'tenant_9b2f1c4a';
const postIds: Array<string> = [
  '8f14e45f-ea82-4c7a-b6b2-1a2b3c4d5e6f',
  'd0e1f2a3-b4c5-6d7e-8f90-1234567890ab'
];
const sso: string = 'sso_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.signature';
const statsWithoutSSO: GetFeedPostsStats200Response = await getFeedPostsStats(tenantId, postIds);
const statsWithSSO: GetFeedPostsStats200Response = await getFeedPostsStats(tenantId, postIds, sso);

getUserReactsPublic

Параметри

Name	Type	Required
tenantId	string	Да
postIds	Array	Не
sso	string	Не

Одговор

Враћа: GetUserReactsPublic200Response

Пример

getUserReactsPublic Пример

Copy

const tenantId: string = "acme-tenant-8a4d2c";
const postIds: string[] = ["post-645a2f", "post-645a30"];
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyXzEyMyIsImlhdCI6MTY2MTYwMDAwMH0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c";
const result: GetUserReactsPublic200Response = await getUserReactsPublic(tenantId, postIds, sso);

reactFeedPostPublic

Параметри

Име	Тип	Обавезно
tenantId	string	Yes
postId	string	Yes
reactBodyParams	ReactBodyParams	Yes
isUndo	boolean	No
broadcastId	string	No
sso	string	No

Одговор

Враћа: ReactFeedPostPublic200Response

Пример

reactFeedPostPublic Пример

Copy

const tenantId: string = 'd290f1ee-6c54-4b01-90e6-d701748f0851';
const postId: string = 'c1a2b3d4-5678-90ab-cdef-1234567890ab';
const reactBodyParams: ReactBodyParams = { reaction: 'like', emoji: '👍', source: 'web' };
const isUndo: boolean = false;
const broadcastId: string = 'broadcast-2026-03-25-001';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyMTIzIn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
const result: ReactFeedPostPublic200Response = await reactFeedPostPublic(tenantId, postId, reactBodyParams, isUndo, broadcastId, sso);

updateFeedPost

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
feedPost	FeedPost	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateFeedPost

Copy

const tenantId: string = 'acme-global-tenant-42';
const id: string = 'f47ac10b-58cc-4372-a567-0e02b2c3d479';
const asset: FeedPostMediaItemAsset = {
  url: 'https://cdn.acme.com/images/product-launch.jpg',
  mimeType: 'image/jpeg',
  width: 1200,
  height: 630
};
const mediaItem: FeedPostMediaItem = {
  id: 'media-001',
  type: 'image',
  asset
};
const link: FeedPostLink = {
  url: 'https://acme.com/blog/product-launch',
  title: 'Product Launch Details'
};
const feedPost: FeedPost = {
  title: 'Introducing the Q3 Product Suite',
  body: 'We are excited to unveil our new lineup for Q3, focusing on performance and security improvements.',
  media: [mediaItem],     // uključen opcioni niz
  links: [link],          // uključeni opcioni linkovi
  isPublished: true       // ovdje se koristi opciona zastavica za objavljivanje
};
const result: FlagCommentPublic200Response = await updateFeedPost(tenantId, id, feedPost);

updateFeedPostPublic

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
postId	string	Да
updateFeedPostParams	UpdateFeedPostParams	Да
broadcastId	string	Не
sso	string	Не

Одговор

Враћа: CreateFeedPostPublic200Response

Пример

Пример updateFeedPostPublic

Copy

const tenantId: string = "tenant_9f4b2";
const postId: string = "post_21a8e";
const updateFeedPostParams: UpdateFeedPostParams = {
  title: "Quarterly product update",
  body: "Major performance improvements and bug fixes deployed today. See release notes and schedule.",
  links: [{ url: "https://status.example.com/release-notes", title: "Release notes" }],
  media: [
    {
      type: "image",
      assets: [{ url: "https://cdn.example.com/updates/q2.png", mimeType: "image/png", width: 1200, height: 628 }]
    }
  ]
};
const broadcastId: string = "broadcast_live_202603";
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example.signature";
const result: CreateFeedPostPublic200Response = await updateFeedPostPublic(tenantId, postId, updateFeedPostParams, broadcastId, sso);

flagCommentPublic

Параметри

Име	Тип	Обавезно
tenantId	string	Да
commentId	string	Да
isFlagged	boolean	Да
sso	string	Не

Одговор

Враћа: FlagCommentPublic200Response

Пример

flagCommentPublic Пример

Copy

const tenantId: string = "tenant_9f8b3c";
const commentId: string = "comment_72a1d4";
const isFlagged: boolean = true;
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI1Njc4OSJ9.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c";
const result: FlagCommentPublic200Response = await flagCommentPublic(tenantId, commentId, isFlagged, sso);

addHashTag

Параметри

Name	Type	Required	Description
tenantId	string	Не
createHashTagBody	CreateHashTagBody	Не

Одговор

Враћа: AddHashTag200Response

Пример

addHashTag Пример

Copy

const tenantId: string = 'tenant_acme_01';
const createHashTagBody: CreateHashTagBody = {
  name: 'feature-request',
  label: 'Feature Request',
  color: '#FF5722',
  enabled: true
};
const response: AddHashTag200Response = await addHashTag(tenantId, createHashTagBody);
const responseWithoutTenant: AddHashTag200Response = await addHashTag(undefined, createHashTagBody);

addHashTagsBulk

Параметри

Назив	Тип	Обавезно	Опис
tenantId	string	Не
bulkCreateHashTagsBody	BulkCreateHashTagsBody	Не

Одговор

Враћа: AddHashTagsBulk200Response

Примјер

Примјер addHashTagsBulk

Copy

// Креирај идентификатор тенанта (опционо)
const tenantId: string = "tenant_9f8c2b7a";
// Припреми појединачне уносе ознака
const tag1: BulkCreateHashTagsBodyTagsInner = {
  name: "product-feedback",
  label: "Product Feedback",
  color: "#1f8a70",
  description: "User suggestions and enhancement requests",
  isActive: true
};
const tag2: BulkCreateHashTagsBodyTagsInner = {
  name: "bug-report",
  label: "Bug Report",
  color: "#d64545",
  description: "User-reported defects and issues",
  isActive: true
};
// Тијело за масовно креирање (опционо)
const bulkCreateHashTagsBody: BulkCreateHashTagsBody = {
  tags: [tag1, tag2]
};
// Позови глобалну асинхрону функцију и додјели типизовани резултат
const result: AddHashTagsBulk200Response = await addHashTagsBulk(tenantId, bulkCreateHashTagsBody);

deleteHashTag

Parametri

Ime	Tip	Obavezno
tag	string	Da
tenantId	string	Ne
deleteHashTagRequest	DeleteHashTagRequest	Ne

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

deleteHashTag Primjer

Copy

const tag: string = "breaking-news";
const tenantId: string = "tenant_12345";
const deleteRequest: DeleteHashTagRequest = { initiatedBy: "moderator@newsorg.com", purgeAllOccurrences: true };
const result: FlagCommentPublic200Response = await deleteHashTag(tag, tenantId, deleteRequest);

getHashTags

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
page	number	Не

Одговор

Враћа: GetHashTags200Response

Пример

getHashTags Пример

Copy

const tenantId: string = 'acme-tenant-42';
const pageNumber: number = 2;
const responseWithPage: GetHashTags200Response = await getHashTags(tenantId, pageNumber);
const responseWithoutPage: GetHashTags200Response = await getHashTags(tenantId);

patchHashTag

Параметри

Име	Тип	Обавезно
tag	string	Да
tenantId	string	Не
updateHashTagBody	UpdateHashTagBody	Не

Одговор

Враћа: PatchHashTag200Response

Пример

patchHashTag Пример

Copy

const tag: string = "feature-ux-refresh";
const tenantId: string = "tenant_4f92c1";
const updateHashTagBody: UpdateHashTagBody = {
  label: "UX Refresh",
  description: "Track comments related to the 2026 UX redesign",
  isActive: true,
  metadata: { owner: "product-design", rolloutPhase: "phase-2" }
};
const response: PatchHashTag200Response = await patchHashTag(tag, tenantId, updateHashTagBody);

createModerator

Параметри

Назив	Тип	Обавезно	Опис
tenantId	string	Да
createModeratorBody	CreateModeratorBody	Да

Одговор

Враћа: CreateModerator200Response

Примјер

createModerator Примјер

Copy

const tenantId: string = 'tenant_7d9f2b4a';
const customConfig: CustomConfigParameters = { timezone: 'UTC', moderationQueueEnabled: true };
const createModeratorBody: CreateModeratorBody = {
  email: 'jane.martin@publisher.com',
  displayName: 'Jane Martin',
  roles: ['moderator'],
  sendWelcomeEmail: true,
  customConfig
};
const response: CreateModerator200Response = await createModerator(tenantId, createModeratorBody);

deleteModerator

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
sendEmail	string	Ne

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

deleteModerator Primjer

Copy

const tenantId: string = 'tenant_9f3b2d4a6c';
const moderatorId: string = 'moderator_84a1b9c2';
const sendEmail: string = 'true';
const result: FlagCommentPublic200Response = await deleteModerator(tenantId, moderatorId, sendEmail);

getModerator

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
id	string	Да

Одговор

Враћа: GetModerator200Response

Примјер

getModerator Примјер

Copy

const tenantId: string = 'acme-corp-tenant-123';
const id: string = 'mod-987654321';
const moderatorResponse: GetModerator200Response = await getModerator(tenantId, id);

getModerators

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Yes
skip	number	No

Одговор

Враћа: GetModerators200Response

Пример

getModerators Пример

Copy

const tenantId: string = 'tenant-12345-prod';
const moderatorsPage1: GetModerators200Response = await getModerators(tenantId);
const moderatorsPage2: GetModerators200Response = await getModerators(tenantId, 50);

sendInvite

Параметри

Име	Тип	Обавезно
tenantId	string	Да
id	string	Да
fromName	string	Да

Одговор

Враћа: FlagCommentPublic200Response

Примјер

sendInvite Примјер

Copy

const tenantId: string = 'tenant_acme-42';
const id: string = 'comment_8f3b21a7';
const fromName: string = 'Elena Morales';
const replyToEmail: string | undefined = undefined;
const result: FlagCommentPublic200Response = await sendInvite(tenantId, id, fromName, replyToEmail);

updateModerator

Parametri

Ime	Tip	Obavezno
tenantId	string	Yes
id	string	Yes
updateModeratorBody	UpdateModeratorBody	Yes

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateModerator

Copy

const tenantId: string = "acme-enterprises-42";
const id: string = "moderator_517";
const updateModeratorBody: UpdateModeratorBody = {
  displayName: "Sofia Martinez",
  email: "sofia.martinez@acme.com",
  permissions: ["approve_comments", "flag_spam", "suspend_users"],
  active: true,
  avatarUrl: "https://cdn.acme.com/avatars/sofia.jpg" // neobavezno polje (prikazano)
};
const result: FlagCommentPublic200Response = await updateModerator(tenantId, id, updateModeratorBody);

deleteNotificationCount

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

deleteNotificationCount Primjer

Copy

const tenantSuffix: string | undefined = undefined;
const tenantId: string = tenantSuffix ? `tenant-${tenantSuffix}` : 'tenant-9142a7';
const id: string = '3f9b2a44-1c2e-4d3b-9f6a-8e7c6d5b2a1f';
const result: FlagCommentPublic200Response = await deleteNotificationCount(tenantId, id);
console.log(result);

getCachedNotificationCount

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
id	string	Да

Одговор

Враћа: GetCachedNotificationCount200Response

Примјер

getCachedNotificationCount Примјер

Copy

const tenantId: string = 'tenant_acme_42';
const id: string = 'user_00012345';
const includeUnreadOnly: boolean | undefined = true; // флаг необавезног параметра (приказано)
const result: GetCachedNotificationCount200Response = await getCachedNotificationCount(tenantId, id);

getNotificationCount

Параметри

Име	Тип	Обавезно
tenantId	string	Да
userId	string	Не
urlId	string	Не
fromCommentId	string	Не
viewed	boolean	Не
type	string	Не

Одговор

Враћа: GetNotificationCount200Response

Пример

Пример getNotificationCount

Copy

const tenantId: string = 'tenant_abc123';
const userId: string = 'user_987654321';
const urlId: string = 'https://example.com/news/2026/new-features';
const viewed: boolean = false;
const type: string = 'reply';
const notificationCountResponse: GetNotificationCount200Response = await getNotificationCount(tenantId, userId, urlId, undefined, viewed, type);

getNotifications

Параметри

Име	Тип	Обавезно
tenantId	string	Да
userId	string	Не
urlId	string	Не
fromCommentId	string	Не
viewed	boolean	Не
type	string	Не
skip	number	Не

Одговор

Враћа: GetNotifications200Response

Пример

getNotifications Пример

Copy

const tenantId: string = "tenant_84b3f2";
const userId: string = "user_1279";
const urlId: string = "https://www.example.com/articles/2026/03/25/new-feature";
const fromCommentId: string = "cmt_5421";
const viewed: boolean = false;
const type: string = "mention";
const skip: number = 0;
const notifications: GetNotifications200Response = await getNotifications(tenantId, userId, urlId, fromCommentId, viewed, type, skip);

updateNotification

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
id	string	Да
updateNotificationBody	UpdateNotificationBody	Да
userId	string	Не

Одговор

Враћа: FlagCommentPublic200Response

Пример

Пример за updateNotification

Copy

const tenantId: string = 'tenant_prod_8f4b2c';
const id: string = 'notification_61a2e9';
const userId: string = 'moderator_107';
const updateNotificationBody: UpdateNotificationBody = {
  name: 'Flagged Comment Notification',
  enabled: true,
  channels: ['email', 'inbox'],
  templateId: 'tmpl_mod_alerts_01',
  severity: 'high'
};
const result: FlagCommentPublic200Response = await updateNotification(tenantId, id, updateNotificationBody, userId);

addPage

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createAPIPageData	CreateAPIPageData	Da

Odgovor

Vraća: AddPageAPIResponse

deletePage

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
id	string	Да

Одговор

Враћа: DeletePageAPIResponse

getPageByURLId

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
urlId	string	Да

Одговор

Враћа: GetPageByURLIdAPIResponse

getPages

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да

Одговор

Враћа: GetPagesAPIResponse

patchPage

Параметри

Име	Тип	Обавезно
tenantId	string	Да
id	string	Да
updateAPIPageData	UpdateAPIPageData	Да

Одговор

Враћа: PatchPageAPIResponse

deletePendingWebhookEvent

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
id	string	Да

Одговор

Враћа: FlagCommentPublic200Response

Примјер

deletePendingWebhookEvent Примјер

Copy

(async () => {
  const tenantId: string = 'tenant_42f7c9b1';
  const id: string = 'pending_webhook_ev_8f3b9a2d';
  const reason?: string = undefined; // примјер опционалног параметра (није обавезно за функцију)
  const result: FlagCommentPublic200Response = await deletePendingWebhookEvent(tenantId, id);
  console.log(result);
})();

getPendingWebhookEventCount

Параметри

Name	Type	Required
tenantId	string	Да
commentId	string	Не
externalId	string	Не
eventType	string	Не
type	string	Не
domain	string	Не
attemptCountGT	number	Не

Одговор

Враћа: GetPendingWebhookEventCount200Response

Примјер

getPendingWebhookEventCount Примјер

Copy

const tenantId: string = "tenant_8d3b7a2f";
const commentId: string | undefined = "comment_79a2b";
const eventType: string | undefined = "comment.created";
const domain: string | undefined = "forum.acme-corp.com";
const attemptCountGT: number | undefined = 1;
const result: GetPendingWebhookEventCount200Response = await getPendingWebhookEventCount(
  tenantId,
  commentId,
  undefined,
  eventType,
  undefined,
  domain,
  attemptCountGT
);

getPendingWebhookEvents

Параметри

Име	Тип	Обавезно
tenantId	string	Да
commentId	string	Не
externalId	string	Не
eventType	string	Не
type	string	Не
domain	string	Не
attemptCountGT	number	Не
skip	number	Не

Одговор

Враћа: GetPendingWebhookEvents200Response

Пример

getPendingWebhookEvents Пример

Copy

const tenantId: string = 'tenant_9b3f7c';
const commentId: string | undefined = undefined;
const externalId: string | undefined = 'external-572a';
const eventType: string | undefined = 'comment.updated';
const type: string | undefined = 'outbound';
const domain: string | undefined = 'reviews.example.com';
const attemptCountGT: number | undefined = 1;
const skip: number | undefined = 20;
const result: GetPendingWebhookEvents200Response = await getPendingWebhookEvents(
  tenantId,
  commentId,
  externalId,
  eventType,
  type,
  domain,
  attemptCountGT,
  skip
);

createQuestionConfig

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
createQuestionConfigBody	CreateQuestionConfigBody	Да

Одговор

Враћа: CreateQuestionConfig200Response

Пример

Пример за createQuestionConfig

Copy

const tenantId: string = "tenant_9f8b2c";
const option: QuestionConfigCustomOptionsInner = { id: "opt_yes", label: "Yes, helpful", value: "yes" };
const createQuestionConfigBody: CreateQuestionConfigBody = {
  title: "Article usefulness",
  prompt: "Was this article helpful?",
  type: "singleChoice",
  required: false, // необавезни параметар (приказано)
  options: [option],
  saveBehavior: "immediate"
};
const result: CreateQuestionConfig200Response = await createQuestionConfig(tenantId, createQuestionConfigBody);

deleteQuestionConfig

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
id	string	Да

Одговор

Враћа: FlagCommentPublic200Response

Пример

deleteQuestionConfig Пример

Copy

const tenantId: string = "acme-enterprises-01";
const idOptional: string | undefined = "f47ac10b-58cc-4372-a567-0e02b2c3d479";
const id: string = idOptional ?? "11111111-1111-1111-1111-111111111111";
const response: FlagCommentPublic200Response = await deleteQuestionConfig(tenantId, id);

getQuestionConfig

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
id	string	Да

Одговор

Враћа: GetQuestionConfig200Response

Пример

Пример getQuestionConfig

Copy

const tenantId: string = 'acme-tenant-92';
const id: string = 'question-2026-07-42';
const response: GetQuestionConfig200Response = await getQuestionConfig(tenantId, id);
function summarize(cfg: GetQuestionConfig200Response, includeDetails?: boolean): string {
  return includeDetails ? 'Question config (detailed)' : 'Question config (summary)';
}
const summary: string = summarize(response);

getQuestionConfigs

Параметри

Име	Тип	Потребно	Опис
tenantId	string	Да
skip	number	Не

Одговор

Враћа: GetQuestionConfigs200Response

Пример

Пример getQuestionConfigs

Copy

const tenantId: string = "tenant_acme_9876";
const configsWithoutSkip: GetQuestionConfigs200Response = await getQuestionConfigs(tenantId);
const configsWithSkip: GetQuestionConfigs200Response = await getQuestionConfigs(tenantId, 20);

updateQuestionConfig

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
updateQuestionConfigBody	UpdateQuestionConfigBody	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateQuestionConfig

Copy

const tenantId: string = 'tenant_42e8b';
const id: string = 'question_9f4a2';
const updateQuestionConfigBody: UpdateQuestionConfigBody = {
  questionText: 'How helpful was this article?',
  description: 'Shown to users below the question (optional)',
  required: true,
  renderingType: 'Likert' as QuestionRenderingType,
  customOptions: [
    { label: 'Very helpful', value: '5' } as QuestionConfigCustomOptionsInner,
    { label: 'Somewhat helpful', value: '3' } as QuestionConfigCustomOptionsInner,
    { label: 'Not helpful', value: '1' } as QuestionConfigCustomOptionsInner
  ],
  whenSave: 'notify' as QuestionWhenSave
};
const result: FlagCommentPublic200Response = await updateQuestionConfig(tenantId, id, updateQuestionConfigBody);

createQuestionResult

Parametri

Ime	Тип	Обавезно	Опис
tenantId	string	Да
createQuestionResultBody	CreateQuestionResultBody	Да

Одговор

Враћа: CreateQuestionResult200Response

Примјер

Primjer createQuestionResult

Copy

const tenantId: string = "tenant-72b1f4";
const meta: MetaItem[] = [{ key: "platform", value: "web" }];
const createQuestionResultBody: CreateQuestionResultBody = {
  questionId: "question-83472",
  commenterId: "user-5521",
  answers: [{ subQuestionId: "sq-1", value: "Yes" }],
  meta, // neобavezni метаподаци
  note: "Follow-up requested" // приказан необавезни параметар
};
const result: CreateQuestionResult200Response = await createQuestionResult(tenantId, createQuestionResultBody);

deleteQuestionResult

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
id	string	Да

Одговор

Враћа: FlagCommentPublic200Response

Пример

Пример deleteQuestionResult

Copy

const tenantId: string = "org-82479";
const questionId: string = "q-6a3d2e1f";
const includeArchived?: boolean = false; // опциони параметар који демонстрира избор алтернативног циља
const targetId: string = includeArchived ? "q-archived-112233" : questionId;
const result: FlagCommentPublic200Response = await deleteQuestionResult(tenantId, targetId);

getQuestionResult

Параметри

Назив	Тип	Обавезно	Опис
tenantId	string	Да
id	string	Да

Одговор

Враћа: GetQuestionResult200Response

Пример

Пример getQuestionResult

Copy

const post: { title: string; questionId?: string } = { title: 'Product feedback' };
const tenantId: string = 'acme-corp-tenant-01';
const id: string = post.questionId ?? 'q-8f3a7b2c4d9e';
const result: GetQuestionResult200Response = await getQuestionResult(tenantId, id);

getQuestionResults

Параметри

Име	Тип	Обавезно
tenantId	string	Да
urlId	string	Не
userId	string	Не
startDate	string	Не
questionId	string	Не
questionIds	string	Не
skip	number	Не

Одговор

Враћа: GetQuestionResults200Response

Примјер

getQuestionResults Примјер

Copy

const tenantId: string = "tenant_acme_001";
const urlId: string = "articles/product-launch-2026";
const userId: string = "user_2048";
const startDate: string = "2026-03-01T00:00:00Z";
const questionId: string | undefined = undefined;
const questionIds: string | undefined = "q_101,q_102";
const skip: number | undefined = 0;
const result: GetQuestionResults200Response = await getQuestionResults(tenantId, urlId, userId, startDate, questionId, questionIds, skip);

updateQuestionResult

Параметри

Име	Тип	Обавезно
tenantId	string	Да
id	string	Да
updateQuestionResultBody	UpdateQuestionResultBody	Да

Одговор

Враћа: FlagCommentPublic200Response

Пример

Пример updateQuestionResult

Copy

const tenantId: string = 'tenant_7f8b3c';
const id: string = 'questionResult_4621';
const updateQuestionResultBody: UpdateQuestionResultBody = {
  questionId: 'q_1024',
  result: 'flagged',
  score: 0.92,
  notes: 'Automated moderation flagged for review',
  meta: [{ key: 'source', value: 'ai-moderator' }] as MetaItem[], // опционални метаподаци
  status: { code: 'review_pending' } as APIStatus
} as UpdateQuestionResultBody;
const result: FlagCommentPublic200Response = await updateQuestionResult(tenantId, id, updateQuestionResultBody);

aggregateQuestionResults

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
questionId	string	Ne
questionIds	Array	Ne
urlId	string	Ne
timeBucket	AggregateTimeBucket	Ne
startDate	Date	Ne
forceRecalculate	boolean	Ne

Odgovor

Vraća: AggregateQuestionResults200Response

Primjer

aggregateQuestionResults Primjer

Copy

const tenantId: string = 'tenant_acme_98765';
const questionIds: Array<string> = ['q-102', 'q-103'];
const urlId: string = 'url_55b3';
const timeBucket: AggregateTimeBucket = { unit: 'day', size: 7 };
const startDate: Date = new Date('2026-01-01T00:00:00Z');
const forceRecalculate: boolean = true;
const result: AggregateQuestionResults200Response = await aggregateQuestionResults(
  tenantId,
  undefined, // questionId izostavljen, koristi se questionIds umjesto toga
  questionIds,
  urlId,
  timeBucket,
  startDate,
  forceRecalculate
);

bulkAggregateQuestionResults

Parametri

Ime	Tip	Obavezno
tenantId	string	Da
bulkAggregateQuestionResultsRequest	BulkAggregateQuestionResultsRequest	Da
forceRecalculate	boolean	Ne

Odgovor

Vraća: BulkAggregateQuestionResults200Response

Primer

bulkAggregateQuestionResults Primer

Copy

const tenantId: string = "tenant_live_7c9d";
const bulkAggregateQuestionResultsRequest: BulkAggregateQuestionResultsRequest = {
  items: [
    { questionId: "q_feedback_rating", includeSubQuestions: false, filters: { locale: "en-US" } }
  ],
  timeBuckets: [
    { granularity: "day", startUtc: "2026-03-01T00:00:00Z", endUtc: "2026-03-15T00:00:00Z" }
  ]
};
const forceRecalculate: boolean = true;
const result: BulkAggregateQuestionResults200Response = await bulkAggregateQuestionResults(tenantId, bulkAggregateQuestionResultsRequest, forceRecalculate);

combineCommentsWithQuestionResults

Параметри

Име	Type	Обавезно
tenantId	string	Да
questionId	string	Не
questionIds	Array	Не
urlId	string	Не
startDate	Date	Не
forceRecalculate	boolean	Не
minValue	number	Не
maxValue	number	Не
limit	number	Не

Одговор

Враћа: CombineCommentsWithQuestionResults200Response

Пример

Пример combineCommentsWithQuestionResults

Copy

const tenantId: string = 'tenant_9f3a2';
const questionIds: string[] = ['question-42', 'question-43'];
const urlId: string = 'url_5d7b';
const startDate: Date = new Date('2026-02-01T00:00:00Z');
const forceRecalculate: boolean = true;
const minValue: number = 1;
const maxValue: number = 5;
const limit: number = 50;
const result: CombineCommentsWithQuestionResults200Response = await combineCommentsWithQuestionResults(
  tenantId,
  undefined,
  questionIds,
  urlId,
  startDate,
  forceRecalculate,
  minValue,
  maxValue,
  limit
);

addSSOUser

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Да
createAPISSOUserData	CreateAPISSOUserData	Да

Odgovor

Vraća: AddSSOUserAPIResponse

deleteSSOUser

Parametri

Ime	Type	Obavezno
tenantId	string	Da
id	string	Da
deleteComments	boolean	Ne
commentDeleteMode	string	Ne

Odgovor

Vraća: DeleteSSOUserAPIResponse

getSSOUserByEmail

Параметри

Назив	Тип	Обавезно	Опис
tenantId	string	Да
email	string	Да

Одговор

Враћа: GetSSOUserByEmailAPIResponse

getSSOUserById

Parametri

Ime	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetSSOUserByIdAPIResponse

getSSOUsers

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
skip	number	Не

Одговор

Враћа: GetSSOUsers200Response

patchSSOUser

Параметри

Ime	Type	Обавезно
tenantId	string	Да
id	string	Да
updateAPISSOUserData	UpdateAPISSOUserData	Да
updateComments	boolean	Не

Одговор

Враћа: PatchSSOUserAPIResponse

putSSOUser

Параметри

Име	Тип	Обавезно
tenantId	string	Да
id	string	Да
updateAPISSOUserData	UpdateAPISSOUserData	Да
updateComments	boolean	Не

Одговор

Враћа: PutSSOUserAPIResponse

createSubscription

Параметри

Name	Type	Required	Description
tenantId	string	Yes
createAPIUserSubscriptionData	CreateAPIUserSubscriptionData	Yes

Одговор

Враћа: CreateSubscriptionAPIResponse

Пример

createSubscription Пример

Copy

const tenantId: string = "acme-corp-123";
const createAPIUserSubscriptionData: CreateAPIUserSubscriptionData = {
  userId: "u_987654",
  planId: "pro_monthly",
  startDate: new Date().toISOString(),
  trialDays: 14, // опциони параметар, приказано
  metadata: { source: "marketing-email" } // опциони параметар, приказано
};
const result: CreateSubscriptionAPIResponse = await createSubscription(tenantId, createAPIUserSubscriptionData);
const subscription: APIUserSubscription = result.subscription;

deleteSubscription

Параметри

Име	Тип	Обавезно
tenantId	string	Да
id	string	Да
userId	string	Не

Одговор

Враћа: DeleteSubscriptionAPIResponse

getSubscriptions

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
userId	string	Не

Одговор

Враћа: GetSubscriptionsAPIResponse

Пример

getSubscriptions Пример

Copy

const tenantId: string = 'tenant_acme_corp_01';
const userId: string = 'user_76a3b9f2';
const subscriptionsForUser: GetSubscriptionsAPIResponse = await getSubscriptions(tenantId, userId);
const subscriptionsForTenant: GetSubscriptionsAPIResponse = await getSubscriptions(tenantId);

updateSubscription

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
id	string	Да
updateAPIUserSubscriptionData	UpdateAPIUserSubscriptionData	Да
userId	string	Не

Одговор

Враћа: UpdateSubscriptionAPIResponse

Пример

Пример updateSubscription

Copy

const tenantId: string = 'tenant_9f3b2c';
const subscriptionId: string = 'sub_7641a2b3';
const updateData: UpdateAPIUserSubscriptionData = {
  status: 'active',
  planId: 'pro_annual',
  autoRenew: true,
  renewalDate: '2026-04-15T00:00:00Z',
  metadata: { upgradedBy: 'billing-team' }
};
const userId: string = 'user_215';
const result: UpdateSubscriptionAPIResponse = await updateSubscription(tenantId, subscriptionId, updateData, userId);

getTenantDailyUsages

Параметри

Име	Тип	Обавезно
tenantId	string	Да
yearNumber	number	Не
monthNumber	number	Не
dayNumber	number	Не
skip	number	Не

Одговор

Враћа: GetTenantDailyUsages200Response

Пример

getTenantDailyUsages Пример

Copy

const tenantId: string = 'tenant_5f4a3b2c-1d6e-4f9a-b9d8-123456789abc';
const yearNumber: number = 2026;
const monthNumber: number = 3;
const dayNumber: number = 24;
const skip: number = 0;
const result: GetTenantDailyUsages200Response = await getTenantDailyUsages(tenantId, yearNumber, monthNumber, dayNumber, skip);

createTenantPackage

Parametri

Name	Tip	Obavezno	Opis
tenantId	string	Da
createTenantPackageBody	CreateTenantPackageBody	Da

Odgovor

Vraća: CreateTenantPackage200Response

Primjer

Primjer createTenantPackage

Copy

const tenantId: string = 'tenant_acme_001';
const createTenantPackageBody: CreateTenantPackageBody = {
  packageName: 'Standard Moderation',
  description: 'Suitable for small-to-medium sites: basic moderation, spam rules, and analytics',
  maxCommentsPerMinute: 50,
  allowAnonymousComments: false, // opcioni parametar je prosleđen
  // opcionalna polja izostavljena: npr., napredna pravila moderacije, prilagođeni CSS
  customConfigParameters: {
    enableProfanityFilter: true,
    imageContentProfanityLevel: 'medium' // ilustrativna vrijednost; koristi oblik CustomConfigParameters
  }
};
const response: CreateTenantPackage200Response = await createTenantPackage(tenantId, createTenantPackageBody);
console.log(response);

deleteTenantPackage

Параметри

Name	Type	Required	Description
tenantId	string	Да
id	string	Да

Одговор

Враћа: FlagCommentPublic200Response

Пример

Пример deleteTenantPackage

Copy

const tenantId: string = 'tenant_acme_corp_987';
const packageId: string = 'pkg_pro_2026_01';
type DeleteOptions = { force?: boolean; notify?: boolean };
const options: DeleteOptions = { force: true }; // демонстрација опционих параметара
const result: FlagCommentPublic200Response = await deleteTenantPackage(tenantId, packageId);

getTenantPackage

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetTenantPackage200Response

Primer

Primer getTenantPackage

Copy

const tenantId: string = 'tenant_7f3b2c8';
const packageId: string = 'pkg_standard_2026';
const requestOptions: { includeConfig?: boolean } = { includeConfig: true };
const packageResponse: GetTenantPackage200Response = await getTenantPackage(tenantId, packageId);

getTenantPackages

Параметри

Назив	Тип	Обавезно	Опис
tenantId	string	Да
skip	number	Не

Одговор

Враћа: GetTenantPackages200Response

Пример

getTenantPackages Пример

Copy

const tenantId: string = "tenant_7f8e3b4c";
const skip: number = 20;
const packagesDefault: GetTenantPackages200Response = await getTenantPackages(tenantId);
const packagesWithSkip: GetTenantPackages200Response = await getTenantPackages(tenantId, skip);

replaceTenantPackage

Параметри

Име	Тип	Обавезно
tenantId	string	Да
id	string	Да
replaceTenantPackageBody	ReplaceTenantPackageBody	Да

Одговор

Враћа: FlagCommentPublic200Response

Пример

replaceTenantPackage Пример

Copy

const tenantId: string = "tenant-9f3c2a";
const id: string = "pkg_4f8b21";
const replaceTenantPackageBody: ReplaceTenantPackageBody = {
  packageName: "Premium Moderation Pack",
  enabled: true,
  apiStatus: { mode: "active" } as APIStatus,
  customConfigParameters: { maxFlagsBeforeReview: 5 } as CustomConfigParameters,
  voteStyle: "thumbs" as VoteStyle,
  tosConfig: { requireAcceptance: true } as TOSConfig
};
const result: FlagCommentPublic200Response = await replaceTenantPackage(tenantId, id, replaceTenantPackageBody);

updateTenantPackage

Параметри

Name	Type	Required
tenantId	string	Да
id	string	Да
updateTenantPackageBody	UpdateTenantPackageBody	Да

Одговор

Враћа: FlagCommentPublic200Response

Пример

Пример за updateTenantPackage

Copy

const tenantId: string = "tenant_3b7f9d-prod";
const id: string = "pkg_enterprise_2026";
const updateTenantPackageBody: UpdateTenantPackageBody = {
  name: "Enterprise Plus",
  isActive: true,
  // опциона поља су намјерно изостављена (нпр. description, limits)
} as UpdateTenantPackageBody;
const result: FlagCommentPublic200Response = await updateTenantPackage(tenantId, id, updateTenantPackageBody);

createTenantUser

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createTenantUserBody	CreateTenantUserBody	Da

Odgovor

Vraća: CreateTenantUser200Response

Primjer

createTenantUser Primjer

Copy

const tenantId: string = 'tenant_6f4b2c';
const createTenantUserBody: CreateTenantUserBody = {
  email: 'sara.kim@example.com',
  displayName: 'Sara Kim',
  role: 'moderator',
  notifyOnMentions: true
};
const result: CreateTenantUser200Response = await createTenantUser(tenantId, createTenantUserBody);

deleteTenantUser

Параметри

Име	Тип	Обавезно
tenantId	string	Да
id	string	Да
deleteComments	string	Не
commentDeleteMode	string	Не

Одговор

Враћа: FlagCommentPublic200Response

Пример

deleteTenantUser Пример

Copy

const tenantId: string = '4f3a9b2e-1c6a-4f7b-9e2a-0b8d6f1c2a3e';
const userId: string = '9d2f7b3a-5c4e-48a2-b1f0-6c7d8e9f0a12';
const deleteComments: string = 'true';
const commentDeleteMode: string = 'permanent';
const result: FlagCommentPublic200Response = await deleteTenantUser(tenantId, userId, deleteComments, commentDeleteMode);

getTenantUser

Параметри

Назив	Тип	Обавезно	Опис
tenantId	string	Да
id	string	Да

Одговор

Враћа: GetTenantUser200Response

Пример

getTenantUser Пример

Copy

const tenantId: string = 'tenant_fc5a9b2c';
const userId: string = 'user_0a12b3';
const result: GetTenantUser200Response = await getTenantUser(tenantId, userId);
const user: User | undefined = (result as any).user; // приступање payload-у
const userEmail: string | undefined = user?.email;
console.log('Fetched user email:', userEmail);

getTenantUsers

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
skip	number	Не

Одговор

Враћа: GetTenantUsers200Response

Пример

getTenantUsers Пример

Copy

const tenantId: string = 'tenant_prod_8a3f2c';
const skip: number = 50;
const usersWithSkip: GetTenantUsers200Response = await getTenantUsers(tenantId, skip);
const usersNoSkip: GetTenantUsers200Response = await getTenantUsers(tenantId);

replaceTenantUser

Параметри

Назив	Тип	Потребно
tenantId	string	Да
id	string	Да
replaceTenantUserBody	ReplaceTenantUserBody	Да
updateComments	string	Не

Одговор

Враћа: FlagCommentPublic200Response

Пример

replaceTenantUser пример

Copy

const tenantId: string = 'tenant_9d8f4b2c';
const id: string = 'user_f47ac10b';
const replaceTenantUserBody: ReplaceTenantUserBody = {
  externalId: 'ext-5234',
  email: 'jane.doe@acme.com',
  displayName: 'Jane Doe',
  roles: ['moderator'],
  metadata: { department: 'product', region: 'us-east-1' }
};
const updateComments: string = 'propagate-display-name-to-comments';
const result: FlagCommentPublic200Response = await replaceTenantUser(tenantId, id, replaceTenantUserBody, updateComments);

sendLoginLink

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
redirectURL	string	Ne

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer sendLoginLink

Copy

const tenantId: string = "tenant_12a9f3b7";
const id: string = "user_84b2c7d1";
const redirectURL: string = "https://app.mycompany.com/welcome?ref=login_email";
const resultWithoutRedirect: FlagCommentPublic200Response = await sendLoginLink(tenantId, id);
const resultWithRedirect: FlagCommentPublic200Response = await sendLoginLink(tenantId, id, redirectURL);

updateTenantUser

Параметри

Име	Тип	Обавезно
tenantId	string	Да
id	string	Да
updateTenantUserBody	UpdateTenantUserBody	Да
updateComments	string	Не

Одговор

Враћа: FlagCommentPublic200Response

Пример

Пример updateTenantUser

Copy

const tenantId: string = "tenant_8f3b2a9d";
const id: string = "user_52c9f1ab";
const updateTenantUserBody: UpdateTenantUserBody = {
  email: "jane.doe@example.com",
  displayName: "Jane Doe",
  roles: ["moderator"],
  isActive: true,
  metadata: { signupSource: "sso", locale: "en-US" }
};
const updateComments: string = "Promoted to moderator and updated display name";
const result: FlagCommentPublic200Response = await updateTenantUser(tenantId, id, updateTenantUserBody, updateComments);

createTenant

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
createTenantBody	CreateTenantBody	Да

Одговор

Враћа: CreateTenant200Response

Пример

createTenant Пример

Copy

const tenantId: string = "acme-corp-001";
const createTenantBody: CreateTenantBody = {
  name: "Acme Corporation",
  domain: "comments.acme.com",
  adminContact: { name: "Jane Doe", email: "jane.doe@acme.com" },
  billingInfo: { planId: "pro-monthly", billingContactEmail: "billing@acme.com" },
  importedSite: { siteId: "site-123", siteName: "Acme Blog" } // опционо увезен сајт
};
const result: CreateTenant200Response = await createTenant(tenantId, createTenantBody);

deleteTenant

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
sure	string	Ne

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

deleteTenant Primjer

Copy

const tenantId: string = "tenant_7f3d2c";
const id: string = "flag_8392b1a7";
const sure: string = "confirmed";
const responseWithoutSure: FlagCommentPublic200Response = await deleteTenant(tenantId, id);
const responseWithSure: FlagCommentPublic200Response = await deleteTenant(tenantId, id, sure);

getTenant

Параметри

Име	Тип	Потребно	Опис
tenantId	string	Да
id	string	Да

Одговор

Враћа: GetTenant200Response

Пример

getTenant Пример

Copy

const tenantId: string = "tenant_9f4b2c1a";
const idOverride: string | undefined = undefined; // опционо преписивање, ако је доступно
const id: string = idOverride ?? "site_3e7a6b2f";
const response: GetTenant200Response = await getTenant(tenantId, id);
console.log(response);

getTenants

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
meta	string	Не
skip	number	Не

Одговор

Враћа: GetTenants200Response

Примјер

getTenants Примјер

Copy

const tenantId: string = 'tenant_8421e7';
const meta: string = 'include=domains,billing,customConfig';
const skip: number = 20;
const tenantsBasic: GetTenants200Response = await getTenants(tenantId);
const tenantsWithOptions: GetTenants200Response = await getTenants(tenantId, meta, skip);

updateTenant

Параметри

Назив	Тип	Обавезно
tenantId	string	Yes
id	string	Yes
updateTenantBody	UpdateTenantBody	Yes

Одговор

Враћа: FlagCommentPublic200Response

Пример

Пример updateTenant

Copy

const tenantId: string = "tenant_4821";
const id: string = "flag_7b9e";
const billingInfo: BillingInfo | undefined = undefined; // опционално, изоставите да бисте задржали тренутне податке о наплати
const updateTenantBody: UpdateTenantBody = {
  name: "Acme News Comments",
  defaultDomain: "comments.acme.com",
  ...(billingInfo ? { billingInfo } : {})
};
const result: FlagCommentPublic200Response = await updateTenant(tenantId, id, updateTenantBody);

changeTicketState

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
userId	string	Да
id	string	Да
changeTicketStateBody	ChangeTicketStateBody	Да

Одговор

Враћа: ChangeTicketState200Response

Пример

Пример changeTicketState

Copy

const tenantId: string = 'tenant_82f9b3';
const userId: string = 'user_9472';
const id: string = 'ticket_550e8400-e29b-41d4-a716-446655440000';
const changeTicketStateBody: ChangeTicketStateBody = {
  state: 'resolved',
  comment: 'Confirmed fix deployed to production; closing ticket.',
  notifySubscribers: true
};
const result: ChangeTicketState200Response = await changeTicketState(tenantId, userId, id, changeTicketStateBody);

createTicket

Параметри

Име	Тип	Обавезно
tenantId	string	Да
userId	string	Да
createTicketBody	CreateTicketBody	Да

Одговор

Враћа: CreateTicket200Response

Примјер

createTicket Примјер

Copy

const tenantId: string = "acme-corp-001";
const userId: string = "user_72b9f4";
const createTicketBody: CreateTicketBody = {
  subject: "Subscription renewal failed for card on file",
  description: "Customer's card was declined by the payment processor during automatic renewal. Transaction ID: txn_9a8b7c. Please review gateway logs and retry.",
  priority: "high", // необавезно поље (пример)
  contactEmail: "billing@acme-corp.com", // необавезна контакт информација
  relatedUrl: "https://acme-corp.com/account/billing"
};
const ticketResponse: CreateTicket200Response = await createTicket(tenantId, userId, createTicketBody);

getTicket

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
id	string	Да
userId	string	Не

Одговор

Враћа: GetTicket200Response

Пример

getTicket Пример

Copy

const tenantId: string = 'acme-corp-tenant-01';
const ticketId: string = 'tkt-20260325-42';
const userId: string = 'user-8452';
const ticketResponseWithUser: GetTicket200Response = await getTicket(tenantId, ticketId, userId);
const ticketResponseWithoutUser: GetTicket200Response = await getTicket(tenantId, ticketId);

getTickets

Параметри

Име	Тип	Обавезно
tenantId	string	Да
userId	string	Не
state	number	Не
skip	number	Не
limit	number	Не

Одговор

Враћа: GetTickets200Response

Пример

getTickets Пример

Copy

const tenantId: string = "tenant_92f3b4c1";
const userId: string = "user_742a9f3e";
const state: number = 1;
const skip: number = 0;
const limit: number = 25;
const ticketsFull: GetTickets200Response = await getTickets(tenantId, userId, state, skip, limit);
const ticketsMinimal: GetTickets200Response = await getTickets("tenant_92f3b4c1");

uploadImage

Отпреми и промијени величину слике

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
file	Blob	Да
sizePreset	SizePreset	Не
urlId	string	Не

Одговор

Враћа: UploadImageResponse

getUserBadgeProgressById

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
id	string	Да

Одговор

Враћа: GetUserBadgeProgressById200Response

Примјер

getUserBadgeProgressById Примјер

Copy

const optionalTenantSuffix: string | undefined = undefined;
const tenantId: string = `5f8d0d55-1234-4ab1-9e2a-3f2b5c6d7e8f${optionalTenantSuffix ?? ''}`;
const id: string = '3a2b1c4d-5678-4ef0-9abc-def123456789';
const result: GetUserBadgeProgressById200Response = await getUserBadgeProgressById(tenantId, id);

getUserBadgeProgressByUserId

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
userId	string	Да

Одговор

Враћа: GetUserBadgeProgressById200Response

Пример

Пример за getUserBadgeProgressByUserId

Copy

const tenantId: string = 'tenant_7f9c2d3b';
const maybeUserId: string | undefined = 'user_4b8e1f9a'; // опциони извор (може бити undefined)
const userId: string = maybeUserId ?? 'user_fallback0001';
const result: GetUserBadgeProgressById200Response = await getUserBadgeProgressByUserId(tenantId, userId);
console.log(result);

getUserBadgeProgressList

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
userId	string	Не
limit	number	Не
skip	number	Не

Одговор

Враћа: GetUserBadgeProgressList200Response

Пример

Пример getUserBadgeProgressList

Copy

(async () => {
  const tenantId: string = 'tenant_4f8c2b9d';
  const userId: string = 'user_9a7e215c';
  const limit: number = 25;
  const skip: number = 0;
  const resultMinimal: GetUserBadgeProgressList200Response = await getUserBadgeProgressList(tenantId);
  const resultFull: GetUserBadgeProgressList200Response = await getUserBadgeProgressList(tenantId, userId, limit, skip);
  console.log(resultMinimal, resultFull);
})();

createUserBadge

Параметри

Назив	Тип	Обавезно	Опис
tenantId	string	Да
createUserBadgeParams	CreateUserBadgeParams	Да

Одговор

Враћа: CreateUserBadge200Response

Пример

createUserBadge Пример

Copy

const tenantId: string = 'tenant_84f3b2';
const createUserBadgeParams: CreateUserBadgeParams = {
  name: 'Top Contributor',
  slug: 'top-contributor',
  imageUrl: 'https://assets.fastcomments.com/badges/top-contributor.png',
  description: 'Awarded for 100 helpful comments',
  active: true,
  criteria: { commentsCount: 100 }, // опционални критеријуми
  displayOrder: 10,
  metadata: { featured: true } // опционални метаподаци
};
const result: CreateUserBadge200Response = await createUserBadge(tenantId, createUserBadgeParams);
console.log(result);

deleteUserBadge

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
id	string	Да

Одговор

Враћа: UpdateUserBadge200Response

Пример

Пример deleteUserBadge

Copy

type DeleteOptions = { notifyModerators?: boolean };
const tenantId: string = 'tenant_8a3f21';
const id: string = 'badge_71f2b';
const options: DeleteOptions = { notifyModerators: true };
const result: UpdateUserBadge200Response = await deleteUserBadge(tenantId, id);

getUserBadge

Параметри

Име	Тип	Обавезно	Опис
tenantId	string	Да
id	string	Да

Одговор

Враћа: GetUserBadge200Response

Пример

getUserBadge Пример

Copy

const tenantId: string = "tenant_acme_01";
const id: string = "badge_8c7d2f";
const response: GetUserBadge200Response = await getUserBadge(tenantId, id);

getUserBadges

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
userId	string	Ne
badgeId	string	Ne
type	number	Ne
displayedOnComments	boolean	Ne
limit	number	Ne
skip	number	Ne

Odgovor

Vraća: GetUserBadges200Response

Primjer

getUserBadges Primjer

Copy

const tenantId: string = 'tenant_acme_01';
const userId: string = 'user_5f4d3c2a';
const badgeId: string = 'badge_top_contributor';
const type: number = 1;
const displayedOnComments: boolean = true;
const limit: number = 50;
const skip: number = 0;
const result: GetUserBadges200Response = await getUserBadges(tenantId, userId, badgeId, type, displayedOnComments, limit, skip);

updateUserBadge

Параметри

Име	Тип	Обавезно
tenantId	string	Да
id	string	Да
updateUserBadgeParams	UpdateUserBadgeParams	Да

Одговор

Враћа: UpdateUserBadge200Response

Пример

Пример updateUserBadge

Copy

(async () => {
  const tenantId: string = 'tenant_acme_987';
  const id: string = 'badge_top_contributor_42';
  const updateUserBadgeParams: UpdateUserBadgeParams = {
    title: 'Top Contributor',
    description: 'Awarded for reaching 100 high-quality comments',
    color: '#FFD700',
    iconUrl: 'https://cdn.acme.com/badges/top-contributor.svg',
    active: true,
    notifyUsers: true
  } as UpdateUserBadgeParams;
  const result: UpdateUserBadge200Response = await updateUserBadge(tenantId, id, updateUserBadgeParams);
  console.log(result);
})();

getUserNotificationCount

Параметри

Назив	Тип	Обавезно	Опис
tenantId	string	Да
sso	string	Не

Одговор

Враћа: GetUserNotificationCount200Response

Пример

getUserNotificationCount Пример

Copy

(async () => {
  const tenantId: string = '9f1e2d3c-4b5a-6d7e-8f90-123456789abc';
  const ssoToken: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI0MjMifQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
  const resultWithSSO: GetUserNotificationCount200Response = await getUserNotificationCount(tenantId, ssoToken);
  const resultWithoutSSO: GetUserNotificationCount200Response = await getUserNotificationCount(tenantId);
  console.log(resultWithSSO, resultWithoutSSO);
})();

getUserNotifications

Параметри

Name	Type	Required
tenantId	string	Да
pageSize	number	Не
afterId	string	Не
includeContext	boolean	Не
afterCreatedAt	number	Не
unreadOnly	boolean	Не
dmOnly	boolean	Не
noDm	boolean	Не
includeTranslations	boolean	Не
sso	string	Не

Одговор

Враћа: GetUserNotifications200Response

Пример

getUserNotifications Пример

Copy

const tenantId: string = 'tenant_7f3b1c';
const pageSize: number = 25;
const afterId: string = 'notif_b2f9e4';
const includeContext: boolean = true;
const afterCreatedAt: number = Date.now() - 24 * 60 * 60 * 1000;
const unreadOnly: boolean = true;
const dmOnly: boolean = false;
const noDm: boolean = false;
const includeTranslations: boolean = true;
const sso: string = 'sso_tok_user_9f8d7c';
const response: GetUserNotifications200Response = await getUserNotifications(
  tenantId,
  pageSize,
  afterId,
  includeContext,
  afterCreatedAt,
  unreadOnly,
  dmOnly,
  noDm,
  includeTranslations,
  sso
);

resetUserNotificationCount

Параметри

Name	Type	Required	Description
tenantId	string	Да
sso	string	Не

Одговор

Враћа: ResetUserNotifications200Response

Примјер

resetUserNotificationCount Примјер

Copy

(async () => {
  const tenantId: string = "tenant_9f3b2c4a";
  const ssoToken: string | undefined = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9._sample_payload_.signature";
  const responseWithSSO: ResetUserNotifications200Response = await resetUserNotificationCount(tenantId, ssoToken);
  const responseWithoutSSO: ResetUserNotifications200Response = await resetUserNotificationCount(tenantId);
  console.log(responseWithSSO, responseWithoutSSO);
})();

resetUserNotifications

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
afterId	string	Не
afterCreatedAt	number	Не
unreadOnly	boolean	Не
dmOnly	boolean	Не
noDm	boolean	Не
sso	string	Не

Одговор

Враћа: ResetUserNotifications200Response

Пример

Пример за resetUserNotifications

Copy

const tenantId: string = "tenant_prod_4a9f12";
const afterId: string = "notification_87213";
const afterCreatedAt: number = Math.floor(Date.now() / 1000) - 3600;
const unreadOnly: boolean = true;
const dmOnly: boolean = false;
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.example.payload";
const result: ResetUserNotifications200Response = await resetUserNotifications(tenantId, afterId, afterCreatedAt, unreadOnly, dmOnly, undefined, sso);

updateUserNotificationCommentSubscriptionStatus

Омогућите или онемогућите обавјештења за одређени коментар.

Параметри

Назив	Тип	Обавезно
tenantId	string	Yes
notificationId	string	Yes
optedInOrOut	UpdateUserNotificationCommentSubscriptionStatusOptedInOrOutEnum	Yes
commentId	string	Yes
sso	string	No

Одговор

Враћа: UpdateUserNotificationStatus200Response

Примјер

updateUserNotificationCommentSubscriptionStatus Примјер

Copy

const tenantId: string = 'acme-tenant-001';
const notificationId: string = 'notif-2026-03-25-01';
const commentId: string = 'cmt-8f3a2b';
const optedInOrOut: UpdateUserNotificationCommentSubscriptionStatusOptedInOrOutEnum = UpdateUserNotificationCommentSubscriptionStatusOptedInOrOutEnum.OptIn;
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.sso-payload.signature';
const result: UpdateUserNotificationStatus200Response = await updateUserNotificationCommentSubscriptionStatus(tenantId, notificationId, optedInOrOut, commentId, sso);

updateUserNotificationPageSubscriptionStatus

Omogućite ili onemogućite obavještenja za stranicu. Kada su korisnici pretplaćeni na stranicu, obavještenja se kreiraju za nove root komentare, i također

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
urlId	string	Da
url	string	Da
pageTitle	string	Da
subscribedOrUnsubscribed	UpdateUserNotificationPageSubscriptionStatusSubscribedOrUnsubscribedEnum	Da
sso	string	Ne

Odgovor

Vraća: UpdateUserNotificationStatus200Response

Primjer

Primjer za updateUserNotificationPageSubscriptionStatus

Copy

const tenantId: string = 'acme-tenant-42';
const urlId: string = 'blog-launch-2026';
const url: string = 'https://acme.example.com/blog/launch-march-2026';
const pageTitle: string = 'Acme Product Launch — March 2026';
const subscribedOrUnsubscribed: UpdateUserNotificationPageSubscriptionStatusSubscribedOrUnsubscribedEnum = UpdateUserNotificationPageSubscriptionStatusSubscribedOrUnsubscribedEnum.Subscribed;
const sso: string = 'sso_jwt_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9';
const response: UpdateUserNotificationStatus200Response = await updateUserNotificationPageSubscriptionStatus(tenantId, urlId, url, pageTitle, subscribedOrUnsubscribed, sso);

updateUserNotificationStatus

Параметри

Име	Тип	Обавезно
tenantId	string	Да
notificationId	string	Да
newStatus	UpdateUserNotificationStatusNewStatusEnum	Да
sso	string	Не

Одговор

Враћа: UpdateUserNotificationStatus200Response

Пример

Пример updateUserNotificationStatus

Copy

const tenantId: string = 'tenant_84a2c3';
const notificationId: string = 'notif_20260325_01';
const newStatus: UpdateUserNotificationStatusNewStatusEnum = UpdateUserNotificationStatusNewStatusEnum.Read;
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.sso_signature_example';
const result: UpdateUserNotificationStatus200Response = await updateUserNotificationStatus(tenantId, notificationId, newStatus, sso);

getUserPresenceStatuses

Параметри

Име	Тип	Обавезно
tenantId	string	Да
urlIdWS	string	Да
userIds	string	Да

Одговор

Враћа: GetUserPresenceStatuses200Response

Пример

Пример getUserPresenceStatuses

Copy

const tenantId: string = 'tenant_7f3a2b';
const urlIdWS: string = 'articles/2026/03/25/fastcomments-integration';
const maybeUserIds: string | undefined = 'user_123,user_456'; // опционалан извор
const userIds: string = maybeUserIds ?? 'user_123';
const presence: GetUserPresenceStatuses200Response = await getUserPresenceStatuses(tenantId, urlIdWS, userIds);

searchUsers

Parametri

Name	Tip	Obavezno
tenantId	string	Da
urlId	string	Da
usernameStartsWith	string	Ne
mentionGroupIds	Array	Ne
sso	string	Ne
searchSection	SearchUsersSearchSectionEnum	Ne

Odgovor

Vraća: SearchUsers200Response

Primjer

Primjer za searchUsers

Copy

const tenantId: string = 'tenant_8392';
const urlId: string = 'articles/2026/03/25/fastcomments-release';
const usernameStartsWith: string = 'jo';
const mentionGroupIds: Array<string> = ['editors', 'senior-writers'];
const sso: string = 'sso_jwt_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9';
const searchSection: SearchUsersSearchSectionEnum = SearchUsersSearchSectionEnum.ALL;
const result: SearchUsers200Response = await searchUsers(tenantId, urlId, usernameStartsWith, mentionGroupIds, sso, searchSection);

getUser

Параметри

Назив	Тип	Обавезно	Опис
tenantId	string	Yes
id	string	Yes

Одговор

Враћа: GetUser200Response

Пример

Пример getUser

Copy

const tenantId: string = 'tenant_7b3f42';
const id: string = 'user_9c4d2a';
const userResponse: GetUser200Response = await getUser(tenantId, id);
console.log(userResponse);

createVote

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
commentId	string	Да
direction	CreateVoteDirectionEnum	Да
userId	string	Не
anonUserId	string	Не

Одговор

Враћа: VoteComment200Response

Пример

Пример createVote

Copy

const tenantId: string = 'tenant_9f8b6a';
const commentId: string = 'comment_3b7d2e';
const direction: CreateVoteDirectionEnum = CreateVoteDirectionEnum.Up;
const anonUserId: string = 'anon_4c2a1f';
const voteResult: VoteComment200Response = await createVote(tenantId, commentId, direction, undefined, anonUserId);

deleteVote

Параметри

Назив	Тип	Обавезно
tenantId	string	Да
id	string	Да
editKey	string	Не

Одговор

Враћа: DeleteCommentVote200Response

Пример

deleteVote Пример

Copy

const tenantId: string = "tenant_7c3f2b4a";
const voteId: string = "vote_4f8d9a11";
const editKey: string = "edit_2b9f8c";
const resultWithoutKey: DeleteCommentVote200Response = await deleteVote(tenantId, voteId);
const resultWithKey: DeleteCommentVote200Response = await deleteVote(tenantId, voteId, editKey);

getVotes

Параметри

Name	Type	Required	Description
tenantId	string	Да
urlId	string	Да

Одговор

Враћа: GetVotes200Response

Примјер

getVotes Примјер

Copy

const tenantId: string = 'acme-corp-8f3b';
const refCampaign: string | undefined = 'newsletter-march2026'; // опционални параметар упита
const urlId: string = `https://www.example.com/articles/2026/03/25/fastcomments-integration${refCampaign ? `?ref=${refCampaign}` : ''}`;
const votes: GetVotes200Response = await getVotes(tenantId, urlId);

getVotesForUser

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
urlId	string	Da
userId	string	Ne
anonUserId	string	Ne

Odgovor

Vraća: GetVotesForUser200Response

Primjer

Primjer getVotesForUser

Copy

(async (): Promise<void> => {
  const tenantId: string = "local-news-ny";
  const urlId: string = "articles/2026-03-25/ev-infrastructure-update";
  const userId: string = "user_78b6f3d9";
  const anonUserId: string = "anon_9c3f7a1b";
  const result: GetVotesForUser200Response = await getVotesForUser(tenantId, urlId, userId, anonUserId);
  console.log(result);
})();

Treba vam pomoć?

Ako naiđete na bilo kakve probleme ili imate pitanja u vezi JavaScript/TypeScript SDK-a, molimo vas:

Doprinosi

Doprinosi su dobrodošli! Molimo posjetite GitHub repozitorij za smjernice za doprinos.

Језик 🇲🇪 Српски (Црна Гора)

Почетак рада

API референца

Документaција

Употреба

Агрегирање

Дневници ревизије

Блокирање по коментару

Провера блокираних коментара

Коментари

Конфигурације домена

Шаблони е-поште

Дневник догађаја

Објаве фида

Пријављивање коментара

Хештегови

Модератори

Број обавештења

Обавештења

Странице

Очекујући webhook догађаји

Конфигурације питања

Резултати питања

Агрегација резултата питања

SSO корисници

Претплате

Дневна употреба тенанта

Пакети тенанта

Корисници тенанта

Тенанти

Тикети

Отпремање слике

Напредак значке корисника

Значке корисника

Корисничка обавештења

Статуси присутности корисника

Претрага корисника

Корисници

Гласови

FastComments JavaScript/TypeScript SDK

Репозиторијум

Инсталација

API документација

Kompletna API referenca: docs/api/README.md

Компатибилност прегледача и сервера

Употреба

Коришћење у прегледачу (клијентска страна)

Коришћење на серверу (Node.js)

Увоз само типова

Коришћење појединачних API класа

Окружење прегледача

Серверско окружење

Јавни и заштићени API-ји

Primjer: Korištenje Public API (sigurno za preglednik)

Primjer: Korištenje Default API (samo na serverskoj strani)

SSO (једнократно пријављивање) интеграција

Једноставан SSO (само на серверу)

Сигуран SSO (на серверу, препоручено)

Коришћење SSO из прегледача (са серверски генерисаним токеном)

SSO са креирањем коментара

Чести случајеви употребе

Dobijanje komentara za stranicu

Kreiranje komentara

Glasanje za komentar

Upravljanje korisnicima (zahteva API ključ)

Догађаји уживо (ажурирања у реалном времену)

Догађаји на нивоу странице

Претплата на корисничке догађаје

Добијање userIdWS

Идентификатори емитовања

Обрада грешака

aggregate

Parametri

Odgovor

getAuditLogs

Параметри

Одговор

Пример

blockFromCommentPublic

Параметри