FastComments JavaScript/TypeScript SDK

Ovo je službeni JavaScript/TypeScript SDK za FastComments.

Upravljajte komentarima, korisnicima, SSO-om i moderacijom iz Node.js-a ili preglednika.

Repozitorij

Instalacija

npm install fastcomments-sdk

API dokumentacija

Potpuna referenca API-ja: docs/api/README.md

Kompatibilnost preglednika i poslužitelja

Ovaj SDK koristi dvostruke ulazne točke kako bi osigurao optimalnu kompatibilnost i spriječio pogreške u izvođenju:

fastcomments-sdk/browser - Verzija sigurna za preglednik s nativnim fetch
fastcomments-sdk/server - Puna Node.js verzija s podrškom za SSO
fastcomments-sdk (zadano) - Samo tipovi, sigurno za uvoz bilo gdje

Korištenje

Ovaj SDK pruža odvojene ulazne točke za pregledničko i serversko okruženje kako bi se osigurala optimalna kompatibilnost i sigurnost:

Korištenje u pregledniku (klijentska strana)

Za aplikacije u pregledniku/frontend koristite pregledniku sigurni izvoz koji isključuje Node.js ovisnosti:

// Uvoz siguran za preglednik (bez Node.js ovisnosti)
import { createFastCommentsBrowserSDK } from 'fastcomments-sdk/browser';

// Kreirajte instancu SDK-a za preglednik
const sdk = createFastCommentsBrowserSDK({
  basePath: 'https://fastcomments.com' // optional, defaults to https://fastcomments.com
});

// Koristite javne API-je (nije potreban API ključ - sigurno za preglednike)
const comments = await sdk.publicApi.getCommentsPublic({ 
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id'
});

Korištenje na serveru (Node.js)

Za server/backend aplikacije, koristite puni SDK s SSO i značajkama autentikacije:

// Uvoz za server (uključuje SSO i dizajniran za rad s NodeJS)
import { createFastCommentsSDK } from 'fastcomments-sdk/server';

// Kreirajte instancu SDK-a za server
const sdk = createFastCommentsSDK({
  apiKey: 'your-api-key', // Čuvajte ovo tajnim na serveru!
  basePath: 'https://fastcomments.com' // optional, defaults to https://fastcomments.com
});

// Koristite zaštićene API-je s vašim API ključem
const comments = await sdk.defaultApi.getComments({ 
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id'
});

Uvoz samo tipova

Ako su vam potrebni samo TypeScript tipovi (nema runtime koda), koristite zadani uvoz:

// Samo tipovi (bez runtime ovisnosti - sigurno svugdje)
import type { 
  PublicComment, 
  CreateCommentParams, 
  GetCommentsPublic200Response 
} from 'fastcomments-sdk';

Korištenje pojedinačnih API klasa

Pregledničko okruženje

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

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

const publicApi = new PublicApi(config);

Serversko okruženje

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);

Javni i zaštićeni API-ji

SDK pruža tri glavne klase API-ja:

DefaultApi - Zaštićene krajnje točke koje zahtijevaju vaš API ključ za autentifikaciju. Koristite ih za operacije na strani poslužitelja.
PublicApi - Javne krajnje točke kojima se može pristupiti bez API ključa. One se mogu pozivati izravno iz preglednika/mobilnih uređaja/itd.
HiddenApi - Interni/admin krajnje točke za napredne slučajeve upotrebe.

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

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

const publicApi = new PublicApi();

// Dohvati 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-ja (samo na strani poslužitelja)

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

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

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

Integracija SSO (jedinstveno prijavljivanje)

FastComments podržava SSO za integraciju s vašim postojećim sustavom autentikacije korisnika. SSO funkcionalnost dostupna je samo u server exportu jer zahtijeva kriptografske značajke Node.js.

Jednostavni SSO (samo na strani poslužitelja)

Jednostavni SSO treba generirati na strani poslužitelja i poslati klijentu:

// Kôd na strani poslužitelja (Node.js/backend)
import { FastCommentsSSO, PublicApi } from 'fastcomments-sdk/server';

// Kreirajte jednostavni SSO koristeći ugrađeni 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();

// Pošaljite ssoToken vašem klijentskom kodu
// Klijentski kod može tada koristiti ovaj token s browser SDK-om

Sigurni SSO (na strani poslužitelja, preporučeno)

Sigurni SSO treba implementirati na strani poslužitelja i pruža bolju sigurnost:

// Kôd na strani poslužitelja (Node.js/backend)
import { FastCommentsSSO, PublicApi } from 'fastcomments-sdk/server';

// Kreirajte siguran SSO koristeći ugrađeni 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();

// Koristite s API pozivima na poslužitelju
const publicApi = new PublicApi();
const response = await publicApi.getCommentsPublic({
  tenantId: 'your-tenant-id',
  urlId: 'page-url-id',
  sso: JSON.stringify(ssoConfig)
});

// Ili pošaljite ssoConfig klijentu za korištenje u pregledniku

Korištenje SSO iz preglednika (s tokenom generiranim na serveru)

// Klijentski kod (preglednik)
import { PublicApi } from 'fastcomments-sdk/browser';

// Dohvatite SSO token s vašeg server endpointa
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 // Koristite token SSO generiran na serveru
});

SSO s kreiranjem komentara

// Na strani poslužitelja: Kreirajte SSO i komentar
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)
});

Uobičajeni slučajevi upotrebe

Dohvaćanje komentara za stranicu

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

Stvaranje 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 glas u korist, -1 za glas protiv
  }
});

Upravljanje korisnicima (potreban API ključ)

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

Događaji uživo (ažuriranja u stvarnom vremenu)

Pretplatite se na događaje uživo kako biste dobili ažuriranja u stvarnom vremenu za komentare, glasove i druge aktivnosti.

Događaji na razini stranice

Slušajte događaje uživo na određenoj stranici (komentari, glasovi itd.):

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

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

// Pretplatite se na događaje uživo za stranicu
const subscription = subscribeToChanges(
  config,
  'your-tenant-id', // tenantIdWS
  'page-url-id',    // urlIdWS  
  'user-session-id', // userIdWS (dobijte ovo iz getComments odgovora)
  (event: LiveEvent) => {
    console.log('Live event received:', event);
    
    switch (event.type) {
      case LiveEventType.new_comment:
        console.log('New comment:', event.comment);
        // Ažurirajte svoje korisničko sučelje s novim komentarom
        break;
      case LiveEventType.new_vote:
        console.log('New vote:', event.vote);
        // Ažurirajte brojače glasova u vašem korisničkom sučelju
        break;
      case LiveEventType.updated_comment:
        console.log('Comment updated:', event.comment);
        break;
      default:
        console.log('Other event type:', event.type);
    }
    
    return true; // Vratite true ako je događaj obrađen
  },
  (isConnected: boolean) => {
    console.log('Connection status:', isConnected ? 'Connected' : 'Disconnected');
  }
);

// Close the subscription when done
subscription.close();

Pretplata na korisničke događaje

Slušajte događaje specifične za korisnika (obavijesti, spominjanja itd.):

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

const userConfig = {
  userIdWS: 'user-session-id', // Get this from getComments response
};

// Pretplatite se na osobni feed korisnika
const userSubscription = subscribeToUserFeed(
  userConfig,
  (event: LiveEvent) => {
    console.log('User event received:', event);
    
    switch (event.type) {
      case LiveEventType.notification:
        console.log('New notification:', event.notification);
        // Prikažite obavijest u vašem korisničkom sučelju
        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');
  }
);

// Zatvorite kada završite
userSubscription.close();

Dobivanje userIdWS

Parametar userIdWS je obavezan za događaje uživo i može se dobiti iz odgovora API-ja:

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

// Extract userIdWS from the response
const userIdWS = response.data?.userSessionInfo?.userIdWS;

if (userIdWS) {
  // Now you can subscribe to live events
  const subscription = subscribeToChanges(config, tenantIdWS, urlIdWS, userIdWS, handleEvent);
}

ID-ovi emitiranja

Vidjet ćete da trebate proslijediti broadcastId u nekim API pozivima. Kada primite događaje, dobit ćete ovaj ID natrag, tako da znate zanemariti događaj ako planirate optimistično primijeniti promjene na klijentu (što ćete vjerojatno htjeti učiniti jer pruža najbolji doživljaj). Ovdje proslijedite UUID. ID bi trebao biti dovoljno jedinstven da se ne pojavi dva puta u istoj sesiji preglednika.

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() // Jedinstveni ID za ovu operaciju
  }
});

Rukovanje pogreškama

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);
  }
}

agregacija

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

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
aggregationRequest	AggregationRequest	Da
parentTenantId	string	Ne
includeStats	boolean	Ne

Odgovor

Vraća: Aggregate200Response

Primjer

Primjer za aggregate

Copy

const tenantId: string = 'tenant_78a9';
const parentTenantId: string = 'parent_tenant_01';
const includeStats: boolean = true;
const aggregationRequest: AggregationRequest = {
  operation: { type: 'COUNT' },
  groupBy: ['pageUrl'],
  predicate: { field: 'status', operator: 'EQUALS', value: 'approved' },
  sort: [{ field: 'count', direction: 'DESC' }],
  limit: 25
};
const result: Aggregate200Response = await aggregate(tenantId, aggregationRequest, parentTenantId, includeStats);

dohvatiRevizijskeZapise

Parametri

Naziv	Tip	Obvezno
tenantId	string	Da
limit	number	Ne
skip	number	Ne
order	SORTDIR	Ne
after	number	Ne
before	number	Ne

Odgovor

Vraća: GetAuditLogs200Response

Primjer

getAuditLogs Primjer

Copy

const tenantId: string = 'tenant_5f8d7c3a';
const limit: number = 100;
const skip: number = 0;
const order: SORTDIR = 'DESC' as SORTDIR;
const after: number = Date.now() - 7 * 24 * 60 * 60 * 1000; // prije tjedan dana
const before: number = Date.now();
const result: GetAuditLogs200Response = await getAuditLogs(tenantId, limit, skip, order, after, before);

blokirajIzKomentaraJavno

Parametri

Name	Type	Obavezno
tenantId	string	Da
commentId	string	Da
publicBlockFromCommentParams	PublicBlockFromCommentParams	Da
sso	string	Ne

Odgovor

Vraća: BlockFromCommentPublic200Response

Primjer

Primjer blockFromCommentPublic

Copy

const tenantId: string = 'tenant_6b3f9a2d';
const commentId: string = 'cmt_8f4b12a9';
const publicBlockFromCommentParams: PublicBlockFromCommentParams = {
  reason: 'Repeated promotional links',
  durationMinutes: 60 * 24 * 30, // 30 dana
  escalateToModeration: true
};
const sso: string = 'sso_token_3fH7kLw';
const result: BlockFromCommentPublic200Response = await blockFromCommentPublic(tenantId, commentId, publicBlockFromCommentParams, sso);

poništiBlokaduKomentaraJavno

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
commentId	string	Da
publicBlockFromCommentParams	PublicBlockFromCommentParams	Da
sso	string	Ne

Odgovor

Vraća: UnBlockCommentPublic200Response

Primjer

unBlockCommentPublic Primjer

Copy

const tenantId: string = "tenant-42-production";
const commentId: string = "comment_7f3b2a9d";
const publicBlockFromCommentParams: PublicBlockFromCommentParams = {
  reason: "flag reviewed and determined not to violate policy",
  restoredBy: "moderator_jane",
  restoredAt: new Date().toISOString()
};
const sso: string = "sso_token_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9";
const result: UnBlockCommentPublic200Response = await unBlockCommentPublic(tenantId, commentId, publicBlockFromCommentParams, sso);

provjeraKomentaraZaBlokirane

Parametri

Ime	Tip	Obavezno
tenantId	string	Yes
commentIds	string	Yes
sso	string	No

Odgovor

Vraća: CheckedCommentsForBlocked200Response

Primjer

checkedCommentsForBlocked Primjer

Copy

(async () => {
  const tenantId: string = 'tenant_fa3b2c9e';
  const commentIds: string = 'cmt_112233,cmt_445566';
  const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI0Njc4IiwidGVuYW50IjoidGVuYW50X2ZhM2IifQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
  const resultWithSSO: CheckedCommentsForBlocked200Response = await checkedCommentsForBlocked(tenantId, commentIds, sso);
  const resultWithoutSSO: CheckedCommentsForBlocked200Response = await checkedCommentsForBlocked(tenantId, commentIds);
  console.log(resultWithSSO, resultWithoutSSO);
})();

blokirajKorisnikaIzKomentara

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
blockFromCommentParams	BlockFromCommentParams	Da
userId	string	Ne
anonUserId	string	Ne

Odgovor

Vraća: BlockFromCommentPublic200Response

Primjer

Primjer blockUserFromComment

Copy

const tenantId: string = "tenant_7f3b4c";
const id: string = "comment_9a8b7c6d";
const blockFromCommentParams: BlockFromCommentParams = {
  reason: "Repeated spam links",
  durationHours: 168,
  notifyModerators: true
};
const userId: string | undefined = "user_42";
const anonUserId: string | undefined = undefined;
const result: BlockFromCommentPublic200Response = await blockUserFromComment(tenantId, id, blockFromCommentParams, userId, anonUserId);

kreirajKomentarJavno

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
urlId	string	Da
broadcastId	string	Da
commentData	CommentData	Da
sessionId	string	Ne
sso	string	Ne

Odgovor

Vraća: CreateCommentPublic200Response

Primjer

Primjer createCommentPublic

Copy

const tenantId: string = 'tenant_9a1b2c';
const urlId: string = 'https://www.news-site.com/article/67890';
const broadcastId: string = 'broadcast_2026-06-15-01';
const sessionId: string | undefined = 'sess_abc123xyz';
const sso: string | undefined = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjoiam9yZGFuIiwiaWF0IjoxNjI0MDAwMDB9.signature';
const commentData: CommentData = {
  content: 'Insightful piece — I appreciated the data-backed points and sources cited.',
  authorDisplayName: 'Jordan Miles'
} as CommentData;
const result: CreateCommentPublic200Response = await createCommentPublic(tenantId, urlId, broadcastId, commentData, sessionId, sso);

izbrišiKomentar

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_84a9f2';
const id: string = 'comment_5f3b21';
const contextUserId: string | undefined = 'user_1122';
const isLive: boolean | undefined = true;
async function run(): Promise<void> {
  const result: DeleteComment200Response = await deleteComment(tenantId, id, contextUserId, isLive);
  console.log(result);
}
run();

izbrišiKomentarJavno

Parametri

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

Odgovor

Vraća: DeleteCommentPublic200Response

Primjer

Primjer deleteCommentPublic

Copy

const tenantId: string = 'tenant_acme_42';
const commentId: string = 'c0mment-9f8b7a6';
const broadcastId: string = 'site_homepage_2026-06-15';
const editKey: string = 'ek_3b7a1f59-4d2c-11eb-8dcd-0242ac130003';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.fakePayload.signature';
const result: DeleteCommentPublic200Response = await deleteCommentPublic(tenantId, commentId, broadcastId, editKey, sso);

izbrišiGlasZaKomentar

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
commentId	string	Da
voteId	string	Da
urlId	string	Da
broadcastId	string	Da
editKey	string	Ne
sso	string	Ne

Odgovor

Vraća: DeleteCommentVote200Response

Primjer

Primjer deleteCommentVote

Copy

const tenantId: string = 'tenant_8f3a2b7c';
const commentId: string = 'cmt-5a1f3d92';
const voteId: string = 'vote-3b9c7e1a';
const urlId: string = 'articles/2026/06/typescript-best-practices';
const broadcastId: string = 'broadcast-77f4d2';
const editKey: string = 'edk-9b2f4c';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.sso_payload.signature';
const result: DeleteCommentVote200Response = await deleteCommentVote(tenantId, commentId, voteId, urlId, broadcastId, editKey, sso);

prijaviKomentar

Parametri

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

Odgovor

Vraća: FlagComment200Response

Primjer

flagComment Primjer

Copy

const tenantId: string = "tenant_4f21c9a";
const commentId: string = "cmt_7a12b3e9";
const userId: string = "user_82bd123";
const result: FlagComment200Response = await flagComment(tenantId, commentId, userId);

dohvatiKomentar

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetComment200Response

Primjer

Primjer getComment

Copy

const tenantId: string = 'tenant_6f1a2b';
const commentId: string = 'cmt_4d9e8f';
const includeReplies: boolean | undefined = true; // primjer neobveznog parametra (nije proslijeđeno u getComment)
const result: GetComment200Response = await getComment(tenantId, commentId);
console.log('Fetched comment for tenant:', tenantId, 'comment id:', commentId);
console.log('API response received:', result);

dohvatiKomentare

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
page	number	Ne
limit	number	Ne
skip	number	Ne
asTree	boolean	Ne
skipChildren	number	Ne
limitChildren	number	Ne
maxTreeDepth	number	Ne
urlId	string	Ne
userId	string	Ne
anonUserId	string	Ne
contextUserId	string	Ne
hashTag	string	Ne
parentId	string	Ne
direction	SortDirections	Ne
fromDate	number	Ne
toDate	number	Ne

Odgovor

Vraća: GetComments200Response

Primjer

getComments Primjer

Copy

const tenantId: string = "tenant_9a12b3";
const response: GetComments200Response = await getComments(tenantId, 1, 20, 0, true, 0, 3, 2, "https://mysite.com/posts/678", undefined, undefined, undefined, undefined, "parent_987", undefined, 1716873600000, 1719552000000);

dohvatiKomentareJavno

req tenantId urlId

Parametri

Name	Type	Required
tenantId	string	Da
urlId	string	Da
page	number	Ne
direction	SortDirections	Ne
sso	string	Ne
skip	number	Ne
skipChildren	number	Ne
limit	number	Ne
limitChildren	number	Ne
countChildren	boolean	Ne
fetchPageForCommentId	string	Ne
includeConfig	boolean	Ne
countAll	boolean	Ne
includei10n	boolean	Ne
locale	string	Ne
modules	string	Ne
isCrawler	boolean	Ne
includeNotificationCount	boolean	Ne
asTree	boolean	Ne
maxTreeDepth	number	Ne
useFullTranslationIds	boolean	Ne
parentId	string	Ne
searchText	string	Ne
hashTags	Array	Ne
userId	string	Ne
customConfigStr	string	Ne
afterCommentId	string	Ne
beforeCommentId	string	Ne

Odgovor

Vraća: GetCommentsPublic200Response

Primjer

Primjer getCommentsPublic

Copy

const tenantId: string = 'acme-news';
const urlId: string = '/articles/2026/fastcomments-update';
const page: number = 1;
const skip: number = 0;
const limit: number = 25;
const countChildren: boolean = true;
const includeConfig: boolean = true;
const result: GetCommentsPublic200Response = await getCommentsPublic(
  tenantId,
  urlId,
  page,
  undefined,
  undefined,
  skip,
  undefined,
  limit,
  undefined,
  countChildren,
  undefined,
  includeConfig
);

dohvatiTekstKomentara

Parametri

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

Odgovor

Vraća: GetCommentText200Response

Primjer

Primjer getCommentText

Copy

const tenantId: string = 'tenant_42b7e9';
const commentId: string = 'cmt_9f3a2b';
const editKey: string = 'edk_3f1b7c9d';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.ssoPayload.signature';
const result: GetCommentText200Response = await getCommentText(tenantId, commentId, editKey, sso);

dohvatiImenaKorisnikaGlasovaZaKomentar

Parametri

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

Odgovor

Vraća: GetCommentVoteUserNames200Response

Primjer

Primjer getCommentVoteUserNames

Copy

const tenantId: string = "tenant_67890";
const commentId: string = "comment_abc123";
const dir: number = 1;
const ssoToken: string = "sso-eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9";
const responseWithoutSSO: GetCommentVoteUserNames200Response = await getCommentVoteUserNames(tenantId, commentId, dir);
const responseWithSSO: GetCommentVoteUserNames200Response = await getCommentVoteUserNames(tenantId, commentId, dir, ssoToken);

zaključajKomentar

Parametri

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

Odgovor

Vraća: LockComment200Response

Primjer

Primjer lockComment

Copy

const tenantId: string = 'tenant_42f6c1';
const commentId: string = 'cmt-9a8b7c';
const broadcastId: string = 'brd_2026_06_15';
const ssoToken: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI1Njc4OSIsImlhdCI6MTY1MDAwMDB9.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
const lockedWithSso: LockComment200Response = await lockComment(tenantId, commentId, broadcastId, ssoToken);
const lockedWithoutSso: LockComment200Response = await lockComment(tenantId, commentId, broadcastId);

zakačiKomentar

Parametri

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

Odgovor

Vraća: PinComment200Response

Primjer

pinComment Primjer

Copy

const tenantId: string = "acme-corp-tenant-72";
const commentId: string = "cmt_8f3a2b4c9d";
const broadcastId: string = "live_2026-06-15_21z";
const ssoToken: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.fake.payload.signature";
const responseNoSSO: PinComment200Response = await pinComment(tenantId, commentId, broadcastId);
const responseWithSSO: PinComment200Response = await pinComment(tenantId, commentId, broadcastId, ssoToken);

spremiKomentar

Parametri

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

Odgovor

Vraća: SaveComment200Response

Primjer

Primjer saveComment

Copy

const tenantId: string = "fastcomments-tenant-42";
const createCommentParams: CreateCommentParams = {
  threadId: "article-2026-06-0142",
  content: "Great write-up — I followed the migration steps and everything worked as described.",
  userId: "u_9c72b",
  userName: "Ava R.",
  userAvatarUrl: "https://cdn.example.com/avatars/u_9c72b.png",
  metadata: { platform: "web", locale: "en-US" }
};
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);

masovnoSpremanjeKomentara

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 = "tenant_42a1b7";
const mentions: CommentUserMentionInfo[] = [{ userId: "user_2b9", displayName: "Alex Chen" }];
const hashtags: CommentUserHashTagInfo[] = [{ tag: "performance" }];
const createCommentParams: CreateCommentParams[] = [
  {
    content: "Thanks for the detailed article — the alternative approach worked for me.",
    authorId: "user_8f3c2",
    authorName: "Maya Patel",
    authorEmail: "maya.patel@example.com",
    url: "/articles/optimizing-ts-performance",
    createdAt: new Date().toISOString(),
    mentions,
    hashtags
  }
];
const isLive: boolean = true;
const doSpamCheck: boolean = false;
const sendEmails: boolean = true;
const populateNotifications: boolean = true;
const result: Array<SaveComment200Response> = await saveCommentsBulk(tenantId, createCommentParams, isLive, doSpamCheck, sendEmails, populateNotifications);

postaviTekstKomentara

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
commentId	string	Da
broadcastId	string	Da
commentTextUpdateRequest	CommentTextUpdateRequest	Da
editKey	string	Ne
sso	string	Ne

Odgovor

Vraća: SetCommentText200Response

Primjer

Primjer setCommentText

Copy

const tenantId: string = 'tenant_4f9a2b'
const commentId: string = 'cmt-8421'
const broadcastId: string = 'brd-2026-06-15'
const commentTextUpdateRequest: CommentTextUpdateRequest = { text: 'Updated comment text to clarify the schedule.', mentions: [], hashtags: [] }
const editKey: string = 'editkey_9b12'
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.sso.signature'
const result: SetCommentText200Response = await setCommentText(tenantId, commentId, broadcastId, commentTextUpdateRequest, editKey, sso)

poništiBlokaduKorisnikaZaKomentar

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_7b9c2a';
const id: string = 'comment_4f8e1d';
const unBlockFromCommentParams: UnBlockFromCommentParams = {
  reason: 'User submitted appeal and provided additional context',
  effectiveAt: new Date().toISOString()
};
const userId: string = 'user_92a3f6';
const result: UnBlockCommentPublic200Response = await unBlockUserFromComment(tenantId, id, unBlockFromCommentParams, userId);

poništiPrijavuKomentara

Parametri

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

Odgovor

Vraća: FlagComment200Response

Primjer

Primjer unFlagComment

Copy

const tenantId: string = 'tenant_8f3b2a1f';
const commentId: string = 'cmt_20250614_01';
const userId: string = 'user_47d2b9';
const result: FlagComment200Response = await unFlagComment(tenantId, commentId, userId);

otključajKomentar

Parametri

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

Odgovor

Vraća: LockComment200Response

Primjer

unLockComment Primjer

Copy

const tenantId: string = "tenant-8f3b2c4a";
const commentId: string = "cmt_92a7f3e6";
const broadcastId: string = "brd_1b4c9d20";
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyMTIzIn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c";
const result: LockComment200Response = await unLockComment(tenantId, commentId, broadcastId, sso);

ukloniZakačeniKomentar

Parametri

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

Odgovor

Vraća: PinComment200Response

Primjer

Primjer unPinComment

Copy

const tenantId: string = "tenant_9f3b2c1a";
const commentId: string = "comment_4d2e8a7f";
const broadcastId: string = "broadcast_live_2026_06_15_18";
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.invalid-signature";
const response: PinComment200Response = await unPinComment(tenantId, commentId, broadcastId, sso);
console.log(response);

ažurirajKomentar

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
updatableCommentParams	UpdatableCommentParams	Da
contextUserId	string	Ne
doSpamCheck	boolean	Ne
isLive	boolean	Ne

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateComment

Copy

const tenantId: string = 'tenant_7f3c1b2a';
const commentId: string = 'cmt_8d9f2a4b';
const updatableCommentParams: UpdatableCommentParams = {
  body: 'Updating this comment to clarify the feature behavior and include a timestamp.',
  metadata: { category: 'support', editedReason: 'clarify instructions' },
  visible: true
};
const contextUserId: string = 'user_42';
const doSpamCheck: boolean = true;
const result: FlagCommentPublic200Response = await updateComment(tenantId, commentId, updatableCommentParams, contextUserId, doSpamCheck);

glasajZaKomentar

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
commentId	string	Da
urlId	string	Da
broadcastId	string	Da
voteBodyParams	VoteBodyParams	Da
sessionId	string	Ne
sso	string	Ne

Odgovor

Vraća: VoteComment200Response

Primjer

voteComment Primjer

Copy

const tenantId: string = 'tenant_7f9d2e';
const commentId: string = '5a1d3f9b-2c4e-4a2b-bf7b-1234567890ab';
const urlId: string = 'articles/2026/06/15/typescript-api-patterns';
const broadcastId: string = 'broadcast-20260615-01';
const voteBodyParams: VoteBodyParams = { vote: 'up' };
const sessionId: string = 'sess_9d2f3b45';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyXzEyMyIsImlhdCI6MTY5NzE2MDAwMH0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
const response: VoteComment200Response = await voteComment(
  tenantId,
  commentId,
  urlId,
  broadcastId,
  voteBodyParams,
  sessionId,
  sso
);

dohvatiKomentareZaKorisnika

Parametri

Naziv	Tip	Obavezno
userId	string	Ne
direction	SortDirections	Ne
repliesToUserId	string	Ne
page	number	Ne
includei10n	boolean	Ne
locale	string	Ne
isCrawler	boolean	Ne

Odgovor

Vraća: GetCommentsForUser200Response

Primjer

Primjer getCommentsForUser

Copy

const userId: string = "550e8400-e29b-41d4-a716-446655440000";
const page: number = 2;
const includei10n: boolean = true;
const locale: string = "en-US";
const isCrawler: boolean = false;
const comments: GetCommentsForUser200Response = await getCommentsForUser(
  userId,
  undefined, // direction izostavljen
  undefined, // repliesToUserId izostavljen
  page,
  includei10n,
  locale,
  isCrawler
);
console.log(comments);

dodajKonfiguracijuDomena

Parametri

Name	Type	Required	Description
tenantId	string	Da
addDomainConfigParams	AddDomainConfigParams	Da

Odgovor

Vraća: AddDomainConfig200Response

izbrišiKonfiguracijuDomena

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
domain	string	Da

Odgovor

Vraća: DeleteDomainConfig200Response

dohvatiKonfiguracijuDomena

Parametri

Name	Type	Required	Description
tenantId	string	Da
domain	string	Da

Odgovor

Vraća: GetDomainConfig200Response

dohvatiKonfiguracijeDomena

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da

Odgovor

Vraća: GetDomainConfigs200Response

djelomičnoIzmijeniKonfiguracijuDomena

Parametri

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

Odgovor

Vraća: GetDomainConfig200Response

zamijeniKonfiguracijuDomena

Parametri

Naziv	Tip	Obvezno
tenantId	string	Da
domainToUpdate	string	Da
updateDomainConfigParams	UpdateDomainConfigParams	Da

Odgovor

Vraća: GetDomainConfig200Response

kreirajPredložakEmaila

Parametri

Name	Type	Required	Description
tenantId	string	Da
createEmailTemplateBody	CreateEmailTemplateBody	Da

Odgovor

Vraća: CreateEmailTemplate200Response

Primjer

Primjer createEmailTemplate

Copy

const tenantId: string = "tenant_4f2b1c9e";
const createEmailTemplateBody: CreateEmailTemplateBody = {
  name: "New Comment Notification",
  subject: "Someone replied to your discussion",
  fromName: "Community Team",
  fromAddress: "no-reply@community.example.com",
  htmlBody: "<p>\{{comment.author}} replied: \{{comment.text}}</p>",
  plaintextBody: "\{{comment.author}} replied: \{{comment.text}}",
  previewText: "A new reply on a discussion you follow",
  isDefault: false // neobvezna zastavica koja demonstrira upotrebu opcionalnog parametra
};
const result: CreateEmailTemplate200Response = await createEmailTemplate(tenantId, createEmailTemplateBody);

izbrišiPredložakEmaila

Parametri

Name	Type	Required	Description
tenantId	string	Da
id	string	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer deleteEmailTemplate

Copy

const tenantId: string = "tenant_9c4f1b2a";
const id: string = "emailtmpl_4d2b9a5e";
const requestorNote: string | undefined = undefined; // neobavezni metapodaci (nisu obavezni za funkciju)
const result: FlagCommentPublic200Response = await deleteEmailTemplate(tenantId, id);

izbrišiPogreškuRenderiranjaPredloškaEmaila

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
errorId	string	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer deleteEmailTemplateRenderError

Copy

const tenantId: string = 'tenant-72f3b4';
const templateId: string = 'email_template-9c3a1';
let providedErrorId: string | undefined = undefined; // neobavezna vrijednost, može biti postavljena negdje drugdje
const errorId: string = providedErrorId ?? 'render_err-5d2f7';
const result: FlagCommentPublic200Response = await deleteEmailTemplateRenderError(tenantId, templateId, errorId);

dohvatiPredložakEmaila

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetEmailTemplate200Response

Primjer

Primjer getEmailTemplate

Copy

const tenantId: string = 'tenant_7f3b2c';
const templateId: string = 'welcome-email-2024';
const includeDrafts: boolean | undefined = undefined;
const emailTemplate: GetEmailTemplate200Response = await getEmailTemplate(tenantId, templateId);

dohvatiDefinicijePredložakaEmaila

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da

Odgovor

Vraća: GetEmailTemplateDefinitions200Response

Primjer

Primjer getEmailTemplateDefinitions

Copy

(async () => {
  const tenantId: string = 'tenant_acme_001';
  const options: { includeDrafts?: boolean } = { includeDrafts: true }; // demonstracija neobaveznog parametra
  const templates: GetEmailTemplateDefinitions200Response = await getEmailTemplateDefinitions(tenantId, options);
  console.log(templates);
})();

dohvatiPogreškeRenderiranjaPredložakaEmaila

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
skip	number	Ne

Odgovor

Vraća: GetEmailTemplateRenderErrors200Response

Primjer

getEmailTemplateRenderErrors Primjer

Copy

const tenantId: string = 'acme-tenant-01';
const id: string = 'tmpl_7f9a2b4c';
const skip: number = 20;
const errorsWithSkip: GetEmailTemplateRenderErrors200Response = await getEmailTemplateRenderErrors(tenantId, id, skip);
const errorsFirstPage: GetEmailTemplateRenderErrors200Response = await getEmailTemplateRenderErrors(tenantId, id);

dohvatiPredloškeEmaila

Parametri

Name	Type	Required	Description
tenantId	string	Da
skip	number	Ne

Odgovor

Vraća: GetEmailTemplates200Response

Primjer

Primjer getEmailTemplates

Copy

async function run(): Promise<void> {
  const tenantId: string = "acme-marketing-tenant-001";
  const templatesDefault: GetEmailTemplates200Response = await getEmailTemplates(tenantId);
  const templatesPaged: GetEmailTemplates200Response = await getEmailTemplates(tenantId, 25);
  console.log(templatesDefault, templatesPaged);
}
run();

renderirajPredložakEmaila

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
renderEmailTemplateBody	RenderEmailTemplateBody	Da
locale	string	Ne

Odgovor

Vraća: RenderEmailTemplate200Response

Primjer

Primjer renderEmailTemplate

Copy

const tenantId: string = '7f7e2b90-3a2b-4d9b-9df1-5f0b6b2e8a1c';
const renderEmailTemplateBody: RenderEmailTemplateBody = {
  templateId: 'welcome_email',
  recipient: { email: 'jordan.smith@acme.co', name: 'Jordan Smith' },
  variables: { siteName: 'Acme Forum', verificationUrl: 'https://acme.forum/verify?code=abc123' }
};
const locale: string = 'en-US';
const result: RenderEmailTemplate200Response = await renderEmailTemplate(tenantId, renderEmailTemplateBody, locale);

ažurirajPredložakEmaila

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
updateEmailTemplateBody	UpdateEmailTemplateBody	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateEmailTemplate

Copy

const tenantId: string = 'acme-corp-123';
const id: string = 'template-789';
const locale: string | undefined = 'en-US';
const updateEmailTemplateBody: UpdateEmailTemplateBody = {
  subject: 'Welcome to Acme — Get started',
  bodyHtml: '<p>Hi \{{firstName}}, welcome to Acme. Start by visiting your dashboard.</p>',
  fromName: 'Acme Support',
  fromEmail: 'support@acme.com',
  enabled: true,
  ...(locale ? { locale } : {})
};
const result: FlagCommentPublic200Response = await updateEmailTemplate(tenantId, id, updateEmailTemplateBody);

dohvatiDnevnikDogađaja

req tenantId urlId userIdWS

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
urlId	string	Da
userIdWS	string	Da
startTime	number	Da
endTime	number	Ne

Odgovor

Vraća: GetEventLog200Response

Primjer

getEventLog Primjer

Copy

const tenantId: string = 'tenant_9f3a2b';
const urlId: string = 'news/2026/06/fastcomments-release';
const userIdWS: string = 'ws_user_48291';
const startTime: number = Date.now() - 86_400_000;
const endTime: number = Date.now();
const result: GetEventLog200Response = await getEventLog(tenantId, urlId, userIdWS, startTime, endTime);

dohvatiGlobalniDnevnikDogađaja

req tenantId urlId userIdWS

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
urlId	string	Da
userIdWS	string	Da
startTime	number	Da
endTime	number	Ne

Odgovor

Vraća: GetEventLog200Response

Primjer

getGlobalEventLog Primjer

Copy

const tenantId: string = "tenant_639b7f12";
const urlId: string = "https://www.news-site.com/articles/2026/06/15/important-update-987";
const userIdWS: string = "user_ws_42b7";
const startTime: number = new Date("2026-06-14T00:00:00Z").getTime();
const endTime: number = Date.now();
const eventLog: GetEventLog200Response = await getGlobalEventLog(tenantId, urlId, userIdWS, startTime, endTime);

kreirajObjavuFeeda

Parametri

Ime	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

createFeedPost Primjer

Copy

const tenantId: string = 'tenant_4f2b1c';
const createFeedPostParams: CreateFeedPostParams = {
  content: 'Launching our summer collection today — check it out!',
  authorId: 'user_879',
  media: [
    {
      type: 'image',
      assets: [
        { url: 'https://cdn.myshop.com/uploads/summer-look.jpg', width: 1200, height: 800 } as FeedPostMediaItemAsset
      ]
    } as FeedPostMediaItem
  ],
  links: [
    { url: 'https://myshop.com/new-arrival', title: 'Summer Collection' } as FeedPostLink
  ],
  allowComments: true
};
const broadcastId: string = 'broadcast-2026-06-15-001';
const isLive: boolean = false;
const doSpamCheck: boolean = true;
const skipDupCheck: boolean = false;
const response: CreateFeedPost200Response = await createFeedPost(tenantId, createFeedPostParams, broadcastId, isLive, doSpamCheck, skipDupCheck);

kreirajObjavuFeedaJavno

Parametri

Name	Type	Required
tenantId	string	Da
createFeedPostParams	CreateFeedPostParams	Da
broadcastId	string	Ne
sso	string	Ne

Odgovor

Vraća: CreateFeedPostPublic200Response

Primjer

Primjer createFeedPostPublic

Copy

(async () => {
  const tenantId: string = "tenant_9f8b7c";
  const media: FeedPostMediaItem[] = [{ type: "image", assets: [{ url: "https://cdn.example.com/roadmap.jpg", mimeType: "image/jpeg" }] }];
  const links: FeedPostLink[] = [{ url: "https://company.example.com/roadmap", title: "Full roadmap" }];
  const createFeedPostParams: CreateFeedPostParams = {
    title: "Weekly Product Roadmap Update",
    body: "This week we shipped enhancements to search relevance and fixed top customer bugs.",
    authorId: "user_8321",
    media,
    links,
    visibility: "public"
  };
  const broadcastId: string = "broadcast_2026_06_15";
  const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.sso_payload";
  const response: CreateFeedPostPublic200Response = await createFeedPostPublic(tenantId, createFeedPostParams, broadcastId, sso);
  console.log(response);
})();

izbrišiObjavuFeedaJavno

Parametri

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

Odgovor

Vraća: DeleteFeedPostPublic200Response

Primjer

Primjer deleteFeedPostPublic

Copy

const tenantId: string = 'acme-tenant-42';
const postId: string = 'post_8f3d2a7c';
const broadcastId: string = 'broadcast_2026-06-15_01';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.ssoPayload.signature';
const response: DeleteFeedPostPublic200Response = await deleteFeedPostPublic(tenantId, postId, broadcastId, sso);

dohvatiObjaveFeeda

req tenantId afterId

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
afterId	string	Ne
limit	number	Ne
tags	Array	Ne

Odgovor

Vraća: GetFeedPosts200Response

Primjer

Primjer getFeedPosts

Copy

const tenantId: string = "tenant_74321";
const afterId: string = "post_20250610_9b2f3";
const limit: number = 25;
const tags: Array<string> = ["product-updates", "announcements"];
const response: GetFeedPosts200Response = await getFeedPosts(tenantId, afterId, limit, tags);

dohvatiObjaveFeedaJavno

req tenantId afterId

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
afterId	string	Ne
limit	number	Ne
tags	Array	Ne
sso	string	Ne
isCrawler	boolean	Ne
includeUserInfo	boolean	Ne

Odgovor

Vraća: GetFeedPostsPublic200Response

Primjer

getFeedPostsPublic Primjer

Copy

(async () => {
  const tenantId: string = 'tenant_acme_01';
  const afterId: string = 'post_20250610_842';
  const limit: number = 25;
  const tags: string[] = ['news', 'technology'];
  const sso: string = 'sso_jwt_eyJhbGciOiJIUzI1Ni';
  const isCrawler: boolean = false;
  const includeUserInfo: boolean = true;
  const response: GetFeedPostsPublic200Response = await getFeedPostsPublic(
    tenantId,
    afterId,
    limit,
    tags,
    sso,
    isCrawler,
    includeUserInfo
  );
  console.log(response);
})();

dohvatiStatistikuObjavaFeeda

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
postIds	Array	Da
sso	string	Ne

Odgovor

Vraća: GetFeedPostsStats200Response

Primjer

Primjer getFeedPostsStats

Copy

const tenantId: string = "tenant_98765";
const postIds: string[] = ["post_a1b2c3", "post_d4e5f6"];
const ssoToken: string = "sso_jwt_eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9";
const statsWithoutSSO: GetFeedPostsStats200Response = await getFeedPostsStats(tenantId, postIds);
const statsWithSSO: GetFeedPostsStats200Response = await getFeedPostsStats(tenantId, postIds, ssoToken);

dohvatiKorisničkeReakcijeJavno

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
postIds	Array	Ne
sso	string	Ne

Odgovor

Vraća: GetUserReactsPublic200Response

Primjer

getUserReactsPublic Primjer

Copy

const tenantId: string = 'fastcomments-tenant-4f2b9c';
const postIds: Array<string> = ['post_7a1f9e', 'post_2b3c88'];
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiI1Njc4OSIsImlhdCI6MTYwOTQ0MDAwMH0.signature';
const response: GetUserReactsPublic200Response = await getUserReactsPublic(tenantId, postIds, sso);

reagirajNaObjavuFeedaJavno

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
postId	string	Da
reactBodyParams	ReactBodyParams	Da
isUndo	boolean	Ne
broadcastId	string	Ne
sso	string	Ne

Odgovor

Vraća: ReactFeedPostPublic200Response

Primjer

Primjer reactFeedPostPublic

Copy

const tenantId: string = 'acme-tenant-001';
const postId: string = 'feedpost_78901';
const reactBodyParams: ReactBodyParams = { reaction: 'like', emoji: '👍' };
const isUndo: boolean = false;
const broadcastId: string = 'broadcast_2026_06_15_01';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.signature';
const response: ReactFeedPostPublic200Response = await reactFeedPostPublic(
  tenantId,
  postId,
  reactBodyParams,
  isUndo,
  broadcastId,
  sso
);

ažurirajObjavuFeeda

Parametri

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

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateFeedPost

Copy

const tenantId: string = "tenant_72f3b4c9";
const id: string = "post_ba4f6e18-2d3c-4b7a-91f2-8c0e3a6b5d4f";
const feedPost: FeedPost = {
  title: "June feature rollout",
  body: "Announcing performance improvements and moderation updates available to all sites.",
  authorName: "Platform Team",
  mediaItems: [
    {
      type: "image",
      caption: "Release banner",
      asset: { url: "https://cdn.fastcomments.com/assets/june-banner.jpg", mimeType: "image/jpeg", width: 1200, height: 600 }
    }
  ],
  links: [{ title: "Release notes", url: "https://docs.fastcomments.com/releases/june-2026" }]
} as FeedPost;
const result: FlagCommentPublic200Response = await updateFeedPost(tenantId, id, feedPost);

ažurirajObjavuFeedaJavno

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
postId	string	Da
updateFeedPostParams	UpdateFeedPostParams	Da
broadcastId	string	Ne
sso	string	Ne

Odgovor

Vraća: CreateFeedPostPublic200Response

Primjer

updateFeedPostPublic Primjer

Copy

const tenantId: string = 'tenant_acme_01';
const postId: string = 'post_20260615_001';
const updateFeedPostParams: UpdateFeedPostParams = {
  title: 'Weekly Update: Product Launch',
  content: 'We shipped the 2.0 release today — highlights and links below.',
  media: [{ url: 'https://cdn.acme.com/releases/launch.jpg', type: 'image' }],
  tags: ['release', 'product'],
  isPublic: true
};
const broadcastId: string = 'broadcast_live_42';
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9';
const result: CreateFeedPostPublic200Response = await updateFeedPostPublic(tenantId, postId, updateFeedPostParams, broadcastId, sso);

prijaviKomentarJavno

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
commentId	string	Da
isFlagged	boolean	Da
sso	string	Ne

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer flagCommentPublic

Copy

const tenantId: string = "tenant_4f1b2a9c";
const commentId: string = "comment_8d3e6f12";
const isFlagged: boolean = true;
const sso: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c";
const result: FlagCommentPublic200Response = await flagCommentPublic(tenantId, commentId, isFlagged, sso);

dohvatiVelikiGif

Parametri

Name	Type	Required	Description
tenantId	string	Da
largeInternalURLSanitized	string	Da

Odgovor

Vraća: GetGifLarge200Response

Primjer

Primjer getGifLarge

Copy

const tenantId: string = "tenant_9f8b7c";
const largeInternalURLSanitized: string = "https://cdn.fastcomments.com/gifs/07d3f6_large.gif";
const preferWebP: boolean | undefined = true; // neobavezna preferenca
const urlToUse: string = preferWebP ? largeInternalURLSanitized.replace(".gif", ".webp") : largeInternalURLSanitized;
const response: GetGifLarge200Response = await getGifLarge(tenantId, urlToUse);

pretražiGifove

Parametri

Name	Type	Required
tenantId	string	Da
search	string	Da
locale	string	Ne
rating	string	Ne
page	number	Ne

Odgovor

Vraća: GetGifsSearch200Response

Primjer

Primjer getGifsSearch

Copy

const tenantId: string = "tenant_acme_9876";
const search: string = "cat playing piano";
const locale: string = "en-US";
const rating: string = "pg";
const page: number = 1;
const result: GetGifsSearch200Response = await getGifsSearch(tenantId, search, locale, rating, page);

dohvatiNajpopularnijeGifove

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
locale	string	Ne
rating	string	Ne
page	number	Ne

Odgovor

Vraća: GetGifsTrending200Response

Primjer

Primjer getGifsTrending

Copy

async function main(): Promise<void> {
  const tenantId: string = 'tenant_8b3f2c';
  const locale: string = 'en-US';
  const rating: string = 'pg';
  const page: number = 1;
  const result: GetGifsTrending200Response = await getGifsTrending(tenantId, locale, rating, page);
  console.log(result);
}
main();

dodajHashtag

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Ne
createHashTagBody	CreateHashTagBody	Ne

Odgovor

Vraća: AddHashTag200Response

Primjer

Primjer addHashTag

Copy

const tenantId: string | undefined = "tenant_3c9f7b";
const createHashTagBody: CreateHashTagBody = {
  name: "support",
  title: "Support",
  description: "Questions about product usage, bugs, and account issues",
  color: "#0066CC",
  isActive: true,
  aliases: ["help", "customer-service"]
};
const result: AddHashTag200Response = await addHashTag(tenantId, createHashTagBody);

dodajHashtageMasovno

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Ne
bulkCreateHashTagsBody	BulkCreateHashTagsBody	Ne

Odgovor

Vraća: AddHashTagsBulk200Response

Primjer

Primjer addHashTagsBulk

Copy

const tenantId: string = "tenant_acme_corp_987";
const bulkCreateHashTagsBody: BulkCreateHashTagsBody = {
  tags: [
    { name: "product-update", description: "Announcements about new product releases", visible: true },
    { name: "customer-support", description: "Customer support related discussions", visible: false }
  ],
  createdBy: "moderator_jane"
};
const resultWithTenant: AddHashTagsBulk200Response = await addHashTagsBulk(tenantId, bulkCreateHashTagsBody);
const resultWithoutTenant: AddHashTagsBulk200Response = await addHashTagsBulk(undefined, bulkCreateHashTagsBody);

izbrišiHashtag

Parametri

Name	Type	Required
tag	string	Da
tenantId	string	Ne
deleteHashTagRequest	DeleteHashTagRequest	Ne

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer deleteHashTag

Copy

const tag: string = "breaking-news";
const tenantId: string = "tenant_72a1";
const deleteHashTagRequest: DeleteHashTagRequest = {
  reason: "consolidate-duplicates",
  requestedBy: "moderator@dailypress.com",
  forceDelete: true
};
const result: FlagCommentPublic200Response = await deleteHashTag(tag, tenantId, deleteHashTagRequest);

dohvatiHashtage

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
page	number	Ne

Odgovor

Vraća: GetHashTags200Response

Primjer

Primjer getHashTags

Copy

const tenantId: string = 'tenant_7f4b2c3a';
const tagsFirstPage: GetHashTags200Response = await getHashTags(tenantId);
const tagsSecondPage: GetHashTags200Response = await getHashTags(tenantId, 2);
console.log(tagsFirstPage, tagsSecondPage);

djelomičnoIzmijeniHashtag

Parametri

Naziv	Tip	Obavezno
tag	string	Da
tenantId	string	Ne
updateHashTagBody	UpdateHashTagBody	Ne

Odgovor

Vraća: PatchHashTag200Response

Primjer

patchHashTag Primjer

Copy

const tag: string = "feature-request";
const tenantId: string = "tenant_8f7a3b2c";
const updateHashTagBody: UpdateHashTagBody = {
  displayName: "Feature Request",
  description: "Use this tag for requests to add new features to the product",
  enabled: true
};
const result: PatchHashTag200Response = await patchHashTag(tag, tenantId, updateHashTagBody);

kreirajModeratora

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createModeratorBody	CreateModeratorBody	Da

Odgovor

Vraća: CreateModerator200Response

Primjer

Primjer createModerator

Copy

const tenantId: string = 'tenant_9f3b21';
const createModeratorBody: CreateModeratorBody = {
  moderator: {
    name: 'Alex Rivera',
    email: 'alex.rivera@fastcomments.io',
    role: 'global_moderator',
    enabled: true,
  },
  // prikazani neobavezni parametri:
  notifyUser: true,
  permissions: ['delete_comment', 'edit_comment', 'ban_user'],
  customConfig: { dashboardTheme: 'dark' } as unknown as CustomConfigParameters
};
const result: CreateModerator200Response = await createModerator(tenantId, createModeratorBody);

izbrišiModeratora

Parametri

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

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer deleteModerator

Copy

const tenantId: string = 'tenant_4f3b2c9a';
const id: string = 'mod_9c2d1f7b';
const sendEmail: string = 'true';
const response: FlagCommentPublic200Response = await deleteModerator(tenantId, id, sendEmail);
console.log(response);

dohvatiModeratora

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetModerator200Response

Primjer

getModerator Primjer

Copy

const tenantId: string = 'acme-media-58';
const id: string = 'mod-82f3b9c1';
const moderatorResponse: GetModerator200Response = await getModerator(tenantId, id);

dohvatiModeratore

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
skip	number	Ne

Odgovor

Vraća: GetModerators200Response

Primjer

Primjer getModerators

Copy

const tenantId: string = 'tenant_0a1b2c3d';
const moderators: GetModerators200Response = await getModerators(tenantId);
const skip: number = 20;
const moderatorsPage2: GetModerators200Response = await getModerators(tenantId, skip);

pošaljiPozivnicu

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
fromName	string	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer upotrebe sendInvite

Copy

(async () => {
  const tenantId: string = "tenant_acme_42";
  const id: string = "cmt_8f3b21";
  const fromName: string = "Ava Thompson";
  const inviteResult: FlagCommentPublic200Response = await sendInvite(tenantId, id, fromName);
  console.log(inviteResult);
})();

ažurirajModeratora

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
updateModeratorBody	UpdateModeratorBody	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateModerator

Copy

const tenantId: string = 'acme-tenant-81';
const id: string = 'mod_7f3a2b';
const updateModeratorBody: UpdateModeratorBody = {
  email: 'j.reyes@acme-corp.com',
  displayName: 'Jordan Reyes',
  roles: ['moderator', 'content_reviewer'],
  active: true,
  notes: 'Promoted to senior moderator; monitor flagged content weekly'
};
const result: FlagCommentPublic200Response = await updateModerator(tenantId, id, updateModeratorBody);

izbrišiBrojObavijesti

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Yes
id	string	Yes

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer deleteNotificationCount

Copy

const tenantId: string = 'tenant_5f3d2e1b';
const id: string = 'notification_9a4b1c2';
const result: FlagCommentPublic200Response = await deleteNotificationCount(tenantId, id);

dohvatiPredmemoriraniBrojObavijesti

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetCachedNotificationCount200Response

Primjer

getCachedNotificationCount Primjer

Copy

const tenantId: string = 'fastcomments-tenant-23';
const id: string = 'user_987654';
const cachedCount: GetCachedNotificationCount200Response = await getCachedNotificationCount(tenantId, id);
const maybeId: string | undefined = Math.random() > 0.5 ? 'user_123456' : undefined;
if (maybeId) {
  const optionalCachedCount: GetCachedNotificationCount200Response = await getCachedNotificationCount(tenantId, maybeId);
}

dohvatiBrojObavijesti

Parametri

Name	Type	Required
tenantId	string	Da
userId	string	Ne
urlId	string	Ne
fromCommentId	string	Ne
viewed	boolean	Ne
type	string	Ne

Odgovor

Vraća: GetNotificationCount200Response

Primjer

getNotificationCount Primjer

Copy

const tenantId: string = 'tenant_82a3b9f';
const userId: string = 'user_43721';
const urlId: string = 'https://news.example.com/articles/2026/06/15/coverage-123';
const fromCommentId: string = 'comment_98765';
const viewed: boolean = false;
const notificationType: string = 'mention';
const result: GetNotificationCount200Response = await getNotificationCount(tenantId, userId, urlId, fromCommentId, viewed, notificationType);

dohvatiObavijesti

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
userId	string	Ne
urlId	string	Ne
fromCommentId	string	Ne
viewed	boolean	Ne
type	string	Ne
skip	number	Ne

Odgovor

Vraća: GetNotifications200Response

Primjer

Primjer getNotifications

Copy

const tenantId: string = 'tenant_9f8b7c6a';
const userId: string = 'user_5a4b3c2d';
const urlId: string = 'post_84f2a1b9';
const fromCommentId: string = 'cmt_0a1b2c3d';
const viewed: boolean = false;
const type: string = 'reply';
const skip: number = 0;
const notifications: GetNotifications200Response = await getNotifications(
  tenantId,
  userId,
  urlId,
  fromCommentId,
  viewed,
  type,
  skip
);

ažurirajObavijest

Parametri

Naziv	Tip	Obvezno
tenantId	string	Da
id	string	Da
updateNotificationBody	UpdateNotificationBody	Da
userId	string	Ne

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateNotification

Copy

const tenantId: string = 'tenant_9f3b2c';
const id: string = 'notification_4a1d2e';
const updateNotificationBody: UpdateNotificationBody = {
  enabled: true,
  channels: ['email', 'push'],
  frequency: 'immediate',
  templateId: 'tmpl_77aa'
} as UpdateNotificationBody;
const userId: string = 'user_2468';
const result: FlagCommentPublic200Response = await updateNotification(tenantId, id, updateNotificationBody, userId);

kreirajV1ReakcijuStranice

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
urlId	string	Da
title	string	Ne

Odgovor

Vraća: CreateV1PageReact200Response

Primjer

Primjer createV1PageReact

Copy

(async () => {
  const tenantId: string = 'b12f3c4d-5678-90ab-cdef-1234567890ab';
  const urlId: string = 'https://www.news-site.com/world/2026/election-results';
  const title: string = 'Election results: key takeaways and analysis';
  const responseWithTitle: CreateV1PageReact200Response = await createV1PageReact(tenantId, urlId, title);
  const responseWithoutTitle: CreateV1PageReact200Response = await createV1PageReact(tenantId, urlId);
  console.log(responseWithTitle, responseWithoutTitle);
})();

kreirajV2ReakcijuStranice

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
urlId	string	Da
id	string	Da
title	string	Ne

Odgovor

Vraća: CreateV2PageReact200Response

Primjer

Primjer createV2PageReact

Copy

const tenantId: string = "fastcomments-tenant-72";
const urlId: string = "articles/2026/06/15/product-update";
const id: string = "page-8f3b2a";
const title: string = "Product Update: June 15, 2026";
(async function run(): Promise<void> {
  const response: CreateV2PageReact200Response = await createV2PageReact(tenantId, urlId, id, title);
  console.log(response);
})();

izbrišiV1ReakcijuStranice

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
urlId	string	Da

Odgovor

Vraća: DeleteV1PageReact200Response

Primjer

Primjer deleteV1PageReact

Copy

const tenantId: string = process.env.TENANT_ID ?? 'd3b07384-9f6a-4c2b-8c3e-0a1b2c3d4e5f';
const urlId: string = 'https://acme.com/articles/2026/06/fastcomments-integration';
const result: DeleteV1PageReact200Response = await deleteV1PageReact(tenantId, urlId);

izbrišiV2ReakcijuStranice

Parametri

Naziv	Tip	Obvezno
tenantId	string	Da
urlId	string	Da
id	string	Da

Odgovor

Vraća: DeleteV2PageReact200Response

Primjer

Primjer deleteV2PageReact

Copy

const tenantId: string = "tenant_79021";
const urlId: string = "blog/my-first-post";
const id: string = "reaction_9f8b7c";
let includeHistory: boolean | undefined = undefined; // neobavezna zastavica, koristi se u nekim pozivima
const result: DeleteV2PageReact200Response = await deleteV2PageReact(tenantId, urlId, id);
console.log(result);

dohvatiV1LajkoveStranice

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
urlId	string	Da

Odgovor

Vraća: GetV1PageLikes200Response

Primjer

getV1PageLikes Primjer

Copy

const tenantId: string = 'fastcomments-742';
const urlId: string = 'sports/2026/06/15/world-cup-preview';
const pageLikes: GetV1PageLikes200Response = await getV1PageLikes(tenantId, urlId);

dohvatiV2ReakcijeStranice

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
urlId	string	Da

Odgovor

Vraća: GetV2PageReacts200Response

Primjer

Primjer getV2PageReacts

Copy

const tenantId: string = "tenant_82f4b3a9";
const urlId: string = "https://news.site.com/articles/2026/06/15/product-launch";
const response: GetV2PageReacts200Response = await getV2PageReacts(tenantId, urlId);
console.log(response);

dohvatiKorisnikeV2ReakcijaStranice

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
urlId	string	Da
id	string	Da

Odgovor

Vraća: GetV2PageReactUsers200Response

Primjer

getV2PageReactUsers Primjer

Copy

const tenantId: string = "7421";
const urlId: string = "sports/london-marathon";
const id: string = "reactUser-3fa85f64-5717-4562-b3fc-2c963f66afa6";
const includeDeleted: boolean | undefined = undefined; // neobavezna zastavica (demonstracija)
const result: GetV2PageReactUsers200Response = await getV2PageReactUsers(tenantId, urlId, id);

dodajStranicu

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createAPIPageData	CreateAPIPageData	Da

Odgovor

Vraća: AddPageAPIResponse

izbrišiStranicu

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: DeletePageAPIResponse

dohvatiOfflineKorisnike

Prošli komentatori na stranici koji trenutno nisu online. Sortirano po displayName. Koristite ovo nakon iscrpljivanja /users/online za prikaz odjeljka "Članovi". Kursor paginacija po commenterName: server prolazi djelomični indeks {tenantId, urlId, commenterName} index od afterName prema naprijed koristeći $gt, bez troška $skip.

Parametri

Name	Type	Required
tenantId	string	Da
urlId	string	Da
afterName	string	Ne
afterUserId	string	Ne

Odgovor

Vraća: GetOfflineUsers200Response

Primjer

Primjer getOfflineUsers

Copy

const tenantId: string = 'tenant_prod_001';
const urlId: string = 'article-2026-06-15-how-ai-impacts';
const afterName: string = 'michael.smith';
const afterUserId: string = 'user_72b9';
const response: GetOfflineUsers200Response = await getOfflineUsers(tenantId, urlId, afterName, afterUserId);

dohvatiOnlineKorisnike

Gledatelji stranice koji su trenutno online: osobe čija je websocket sesija trenutno pretplaćena na stranicu. Vraća anonCount + totalCount (pretplatnici sobe u cijelosti, uključujući anonimne gledatelje koje ne navodimo).

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
urlId	string	Da
afterName	string	Ne
afterUserId	string	Ne

Odgovor

Vraća: GetOnlineUsers200Response

Primjer

getOnlineUsers Primjer

Copy

const tenantId: string = 'tenant_14f9c3';
const urlId: string = 'article_20250615';
const afterName: string = 'marie.curie';
const afterUserId: string = 'u_92b7';
const result: GetOnlineUsers200Response = await getOnlineUsers(tenantId, urlId, afterName, afterUserId);

dohvatiStranicuPoURLId

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
urlId	string	Da

Odgovor

Vraća: GetPageByURLIdAPIResponse

dohvatiStranice

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da

Odgovor

Vraća: GetPagesAPIResponse

dohvatiStraniceJavno

Nabrajanje stranica za najmoprimca. Koristi ga FChat desktop klijent za popunjavanje popisa soba. Zahtijeva da je enableFChat postavljeno na true u razriješenoj prilagođenoj konfiguraciji za svaku stranicu. Stranice koje zahtijevaju SSO filtriraju se prema pristupnim grupama korisnika koji šalje zahtjev.

Parametri

Name	Type	Required
tenantId	string	Da
cursor	string	Ne
limit	number	Ne
q	string	Ne
sortBy	PagesSortBy	Ne
hasComments	boolean	Ne

Odgovor

Vraća: GetPagesPublic200Response

Primjer

getPagesPublic Primjer

Copy

const tenantId: string = 'tenant_8f3b2c';
const cursor: string = 'eyJwYWdlIjoiMTIwIn0';
const limit: number = 25;
const q: string = 'homepage hero';
const hasComments: boolean = true;
const response: GetPagesPublic200Response = await getPagesPublic(
  tenantId,
  cursor,
  limit,
  q,
  undefined,
  hasComments
);

dohvatiInformacijeOKorisnicima

Masovne informacije o korisnicima za tenant. Za zadane userIds vraća prikazne informacije iz User / SSOUser. Koristi widget komentara za obogaćivanje korisnika koji su se upravo pojavili putem događaja prisutnosti. Bez konteksta stranice: privatnost se primjenjuje jednako (privatni profili su maskirani).

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
ids	string	Da

Odgovor

Vraća: GetUsersInfo200Response

Primjer

Primjer getUsersInfo

Copy

const tenantId: string = 'acme-tenant-007';
const userIdsList: string[] = ['user_12a', 'user_34b', 'user_56c'];
const separator: string | undefined = undefined; // neobavezno; ako je undefined, zadana vrijednost je zarez
const ids: string = userIdsList.join(separator ?? ',');
const usersInfo: GetUsersInfo200Response = await getUsersInfo(tenantId, ids);

djelomičnoIzmijeniStranicu

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
updateAPIPageData	UpdateAPIPageData	Da

Odgovor

Vraća: PatchPageAPIResponse

izbrišiNeobrađeniWebhookDogađaj

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

deletePendingWebhookEvent Primjer

Copy

const tenantId: string = "tenant_5f8d7a34";
const id: string = "webhook_evt_987654321";
const requestNote: string | undefined = undefined;
const response: FlagCommentPublic200Response = await deletePendingWebhookEvent(tenantId, id);

dohvatiBrojNeobrađenihWebhookDogađaja

Parametri

Name	Type	Obavezno
tenantId	string	Da
commentId	string	Ne
externalId	string	Ne
eventType	string	Ne
type	string	Ne
domain	string	Ne
attemptCountGT	number	Ne

Odgovor

Vraća: GetPendingWebhookEventCount200Response

Primjer

Primjer getPendingWebhookEventCount

Copy

const tenantId: string = 'tenant_9f8b3b';
const commentId: string = 'cmt_1a2b3c';
const eventType: string = 'comment.created';
const domain: string = 'news-site.com';
const attemptCountGT: number = 2;
const result: GetPendingWebhookEventCount200Response = await getPendingWebhookEventCount(
  tenantId,
  commentId,
  undefined, // externalId izostavljen
  eventType,
  undefined, // type izostavljen
  domain,
  attemptCountGT
);

dohvatiNeobrađeneWebhookDogađaje

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
commentId	string	Ne
externalId	string	Ne
eventType	string	Ne
type	string	Ne
domain	string	Ne
attemptCountGT	number	Ne
skip	number	Ne

Odgovor

Vraća: GetPendingWebhookEvents200Response

Primjer

getPendingWebhookEvents Primjer

Copy

const tenantId: string = 'tenant_9f3b2a';
const commentId: string = 'cmt_8a7d1';
const eventType: string = 'comment.created';
const domain: string = 'reviews.myshop.com';
const attemptCountGT: number = 1;
const skip: number = 0;
const result: GetPendingWebhookEvents200Response = await getPendingWebhookEvents(
  tenantId,
  commentId,
  undefined,
  eventType,
  undefined,
  domain,
  attemptCountGT,
  skip
);

kreirajKonfiguracijuPitanja

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createQuestionConfigBody	CreateQuestionConfigBody	Da

Odgovor

Vraća: CreateQuestionConfig200Response

Primjer

Primjer createQuestionConfig

Copy

const tenantId: string = "tenant_9f3b1c2a";
const createQuestionConfigBody: CreateQuestionConfigBody = {
  name: "Product feedback",
  key: "product_quality",
  description: "Short survey question shown after posting a comment",
  required: true,
  renderingType: "singleChoice",
  customOptions: [
    { label: "Excellent", value: "5" },
    { label: "Good", value: "4" },
    { label: "Fair", value: "3" }
  ] as QuestionConfigCustomOptionsInner[],
  notifyModerators: false // demonstriran neobavezni parametar
};
const result: CreateQuestionConfig200Response = await createQuestionConfig(tenantId, createQuestionConfigBody);

izbrišiKonfiguracijuPitanja

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

deleteQuestionConfig Primjer

Copy

const tenantId: string = 'acme-corp-47a9';
const id: string = 'qcfg_20260615_001';
const result: FlagCommentPublic200Response = await deleteQuestionConfig(tenantId, id);

dohvatiKonfiguracijuPitanja

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetQuestionConfig200Response

Primjer

Primjer getQuestionConfig

Copy

const tenantId: string = "acme-corp-47";
const questionId: string = "q-4f2b9a";
const includeDrafts: boolean | undefined = undefined; // rezervirano mjesto za opcionalni parametar
const result: GetQuestionConfig200Response = await getQuestionConfig(tenantId, questionId);
console.log(result);

dohvatiKonfiguracijePitanja

Parametri

Name	Type	Required	Description
tenantId	string	Da
skip	number	Ne

Odgovor

Vraća: GetQuestionConfigs200Response

Primjer

getQuestionConfigs Primjer

Copy

const tenantId: string = "tenant_4c9f2b";
const responseWithoutSkip: GetQuestionConfigs200Response = await getQuestionConfigs(tenantId);
const skip: number = 50;
const responseWithSkip: GetQuestionConfigs200Response = await getQuestionConfigs(tenantId, skip);

ažurirajKonfiguracijuPitanja

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_9f3b8a2e-4c6d-4b4f-a1b2-9e8f7d6c5b3a";
const id: string = "q_7c2e1b4a-5d6f-4a8b-9c3d-2e1f0b9a4c5d";
const options: QuestionConfigCustomOptionsInner[] = [
  { value: "1", label: "Very dissatisfied" },
  { value: "2", label: "Dissatisfied" },
  { value: "3", label: "Neutral" },
  { value: "4", label: "Satisfied" },
  { value: "5", label: "Very satisfied" }
];
const updateQuestionConfigBody: UpdateQuestionConfigBody = {
  label: "How satisfied are you with the article?",
  enabled: true,
  required: false, // neobavezni parametar prikazan
  options
};
const result: FlagCommentPublic200Response = await updateQuestionConfig(tenantId, id, updateQuestionConfigBody);

kreirajRezultatPitanja

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Yes
createQuestionResultBody	CreateQuestionResultBody	Yes

Odgovor

Vraća: CreateQuestionResult200Response

Primjer

Primjer createQuestionResult

Copy

const tenantId: string = 'fc-tenant-512';
const meta: MetaItem[] = [{ key: 'source', value: 'article' }];
const body: CreateQuestionResultBody = {
  questionId: 'q-94',
  userId: 'user_332',
  answers: [{ optionId: 'opt_a', score: 1 }],
  meta, // neobavezni metapodaci
} as CreateQuestionResultBody;
const result: CreateQuestionResult200Response = await createQuestionResult(tenantId, body);

izbrišiRezultatPitanja

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer deleteQuestionResult

Copy

const tenantId: string = "acme-corp-tenant-01";
const id: string = "qres_9f8b7c3a";
const response: FlagCommentPublic200Response = await deleteQuestionResult(tenantId, id);
const optionalResponse: FlagCommentPublic200Response | undefined = response;

dohvatiRezultatPitanja

Parametri

Ime	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetQuestionResult200Response

Primjer

Primjer getQuestionResult

Copy

const tenantId: string = 'tenant_9f3b2a7c9';
const questionId: string = 'q_8d4f1b2c3a';
const options: { includeMeta?: boolean } = { includeMeta: true }; // demonstracija neobveznog parametra
const result: GetQuestionResult200Response = await getQuestionResult(tenantId, questionId);
const apiStatus: APIStatus | undefined = (result as unknown as { apiStatus?: APIStatus }).apiStatus;
const question: QuestionResult | undefined = (result as unknown as { question?: QuestionResult }).question;

dohvatiRezultatePitanja

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
urlId	string	Ne
userId	string	Ne
startDate	string	Ne
questionId	string	Ne
questionIds	string	Ne
skip	number	Ne

Odgovor

Vraća: GetQuestionResults200Response

Primjer

Primjer getQuestionResults

Copy

const tenantId: string = 'fc-tenant-7a9c';
const urlId: string = 'news/article-2026-06-15';
const userId: string = 'user-8421';
const startDate: string = '2026-05-01T00:00:00Z';
const questionId: string = 'q-13';
const questionIds: string = 'q-13,q-14';
const skip: number = 20;
const result: GetQuestionResults200Response = await getQuestionResults(tenantId, urlId, userId, startDate, questionId, questionIds, skip);

ažurirajRezultatPitanja

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
updateQuestionResultBody	UpdateQuestionResultBody	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateQuestionResult

Copy

const tenantId: string = "tenant_prod_84b2";
const id: string = "question_9f3a";
const updateQuestionResultBody: UpdateQuestionResultBody = {
  outcome: "accepted",
  confidence: 0.88,
  moderatorId: "moderator_17",
  notes: "Validated by automated review" // neobavezno polje uključeno
};
const result: FlagCommentPublic200Response = await updateQuestionResult(tenantId, id, updateQuestionResultBody);

agregacijaRezultataPitanja

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_6f2b3c';
const questionIds: Array<string> = ['q-7a1b2c', 'q-8d3e4f'];
const urlId: string = 'url_9f8e7d';
const startDate: Date = new Date('2025-01-01T00:00:00Z');
const result: AggregateQuestionResults200Response = await aggregateQuestionResults(tenantId, undefined, questionIds, urlId, undefined, startDate, true);

masovnaAgregacijaRezultataPitanja

Parametri

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

Odgovor

Vraća: BulkAggregateQuestionResults200Response

Primjer

Primjer bulkAggregateQuestionResults

Copy

const tenantId: string = "tenant_0012";
const bulkAggregateQuestionResultsRequest: BulkAggregateQuestionResultsRequest = {
  items: [
    {
      questionId: "quality_score",
      startTime: "2026-06-01T00:00:00Z",
      endTime: "2026-06-14T00:00:00Z",
      timeBucket: "day",
      dimensions: ["threadId"]
    }
  ],
  includeTotals: true
};
const forceRecalculate: boolean = false;
const result: BulkAggregateQuestionResults200Response = await bulkAggregateQuestionResults(tenantId, bulkAggregateQuestionResultsRequest, forceRecalculate);

kombinirajKomentareSRazultatiPitanja

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
questionId	string	Ne
questionIds	Array	Ne
urlId	string	Ne
startDate	Date	Ne
forceRecalculate	boolean	Ne
minValue	number	Ne
maxValue	number	Ne
limit	number	Ne

Odgovor

Vraća: CombineCommentsWithQuestionResults200Response

Primjer

Primjer combineCommentsWithQuestionResults

Copy

const tenantId: string = 'tenant_12345';
const questionId: string = 'q_98765';
const questionIds: string[] = ['q_98765', 'q_12345'];
const urlId: string = 'url_abc123';
const startDate: Date = new Date('2026-01-01T00:00:00Z');
const forceRecalculate: boolean = true;
const minValue: number = 0;
const maxValue: number = 5;
const limit: number = 50;
const result: CombineCommentsWithQuestionResults200Response = await combineCommentsWithQuestionResults(
  tenantId,
  questionId,
  questionIds,
  urlId,
  startDate,
  forceRecalculate,
  minValue,
  maxValue,
  limit
);

dodajSSOKorisnika

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createAPISSOUserData	CreateAPISSOUserData	Da

Odgovor

Vraća: AddSSOUserAPIResponse

izbrišiSSOKorisnika

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
deleteComments	boolean	Ne
commentDeleteMode	string	Ne

Odgovor

Vraća: DeleteSSOUserAPIResponse

dohvatiSSOKorisnikaPoEmailu

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
email	string	Da

Odgovor

Vraća: GetSSOUserByEmailAPIResponse

dohvatiSSOKorisnikaPoId

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetSSOUserByIdAPIResponse

dohvatiSSOKorisnike

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
skip	number	Ne

Odgovor

Vraća: GetSSOUsers200Response

djelomičnoIzmijeniSSOKorisnika

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
updateAPISSOUserData	UpdateAPISSOUserData	Da
updateComments	boolean	Ne

Odgovor

Vraća: PatchSSOUserAPIResponse

zamijeniSSOKorisnika

Parametri

Ime	Tip	Obavezno
tenantId	string	Da
id	string	Da
updateAPISSOUserData	UpdateAPISSOUserData	Da
updateComments	boolean	Ne

Odgovor

Vraća: PutSSOUserAPIResponse

Primjer

putSSOUser Primjer

Copy

const tenantId: string = 'acme-enterprises-42';
const id: string = 'usr-73a1b2';
const updateAPISSOUserData: UpdateAPISSOUserData = {
  email: 'marcus.ingram@acme.com',
  givenName: 'Marcus',
  familyName: 'Ingram',
  roles: ['editor', 'project_owner'],
  enabled: true
};
const result: PutSSOUserAPIResponse = await putSSOUser(tenantId, id, updateAPISSOUserData, true);

kreirajPretplatu

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createAPIUserSubscriptionData	CreateAPIUserSubscriptionData	Da

Odgovor

Vraća: CreateSubscriptionAPIResponse

Primjer

Primjer createSubscription

Copy

const tenantId: string = "acme-corp-tenant-123";
const createAPIUserSubscriptionData: CreateAPIUserSubscriptionData = {
  userId: "user_98765",
  planId: "pro_monthly",
  paymentMethod: { type: "card", cardId: "card_abc123" },
  autoRenew: true,
  trialDays: 14, // neobavezni parametar prikazan
  metadata: { campaign: "spring_launch" } // neobavezni parametar prikazan
};
const result: CreateSubscriptionAPIResponse = await createSubscription(tenantId, createAPIUserSubscriptionData);

izbrišiPretplatu

Parametri

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

Odgovor

Vraća: DeleteSubscriptionAPIResponse

dohvatiPretplate

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
userId	string	Ne

Odgovor

Vraća: GetSubscriptionsAPIResponse

Primjer

getSubscriptions Primjer

Copy

const tenantId: string = "contoso-9a1b2c";
const userId: string = "u-482f6";
const subscriptions: GetSubscriptionsAPIResponse = await getSubscriptions(tenantId);
const userSubscriptions: GetSubscriptionsAPIResponse = await getSubscriptions(tenantId, userId);

ažurirajPretplatu

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
updateAPIUserSubscriptionData	UpdateAPIUserSubscriptionData	Da
userId	string	Ne

Odgovor

Vraća: UpdateSubscriptionAPIResponse

Primjer

Primjer 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);

dohvatiDnevnuUpotrebuNajmoprimca

Parametri

Name	Type	Required
tenantId	string	Da
yearNumber	number	Ne
monthNumber	number	Ne
dayNumber	number	Ne
skip	number	Ne

Odgovor

Vraća: GetTenantDailyUsages200Response

Primjer

getTenantDailyUsages Primjer

Copy

const tenantId: string = 'tenant_7a3c2e';
const dailyUsages: GetTenantDailyUsages200Response = await getTenantDailyUsages(tenantId, 2026, 6, undefined, 0);

kreirajPaketNajmoprimca

Parameters

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createTenantPackageBody	CreateTenantPackageBody	Da

Odgovor

Vraća: CreateTenantPackage200Response

Primjer

Primjer createTenantPackage

Copy

const tenantId: string = "tenant_7890";
const createTenantPackageBody: CreateTenantPackageBody = {
  packageName: "Growth Plan",
  maxSeats: 2500,
  features: {
    moderation: true,
    analytics: true,
    sso: { enabled: true, provider: "saml" }
  },
  billing: { interval: "monthly", priceCents: 19900 },
  // neobavezni parametar prikazan: notes nije obavezan, ali je naveden
  notes: "Onboarding bundle with priority support"
};
const result: CreateTenantPackage200Response = await createTenantPackage(tenantId, createTenantPackageBody);

izbrišiPaketNajmoprimca

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer deleteTenantPackage

Copy

const tenantId: string = 'acme-corp-tenant-01';
const packageId: string = 'pkg-2026-06-15-001';
const dryRun: boolean | undefined = undefined; // primjer opcionalnog parametra (nije obavezan za funkciju)
const result: FlagCommentPublic200Response = await deleteTenantPackage(tenantId, packageId);

dohvatiPaketNajmoprimca

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetTenantPackage200Response

Primjer

Primjer getTenantPackage

Copy

const tenantId: string = 'tenant_4b8c2a9f';
const packageId: string = 'pkg_7d3e1b5c';
const includeMetadata: boolean | undefined = true;
const packageResponse: GetTenantPackage200Response = await getTenantPackage(tenantId, packageId);

dohvatiPaketeNajmoprimca

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
skip	number	Ne

Odgovor

Vraća: GetTenantPackages200Response

Primjer

Primjer getTenantPackages

Copy

const tenantId: string = 'tenant_8421';
const packagesWithSkip: GetTenantPackages200Response = await getTenantPackages(tenantId, 25);
const packagesWithoutSkip: GetTenantPackages200Response = await getTenantPackages(tenantId);

zamijeniPaketNajmoprimca

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
replaceTenantPackageBody	ReplaceTenantPackageBody	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer replaceTenantPackage

Copy

const tenantId: string = "fastcomments-tenant-114";
const id: string = "pkg-enterprise-2026-06";
const replaceTenantPackageBody: ReplaceTenantPackageBody = {
  name: "EnterpriseModeration",
  version: "2.4.7",
  enabled: true,
  apiStatus: { state: "active", lastUpdated: "2026-06-10T12:00:00Z" },
  customConfigParameters: { maxCommentLength: 1200, allowImages: true }, // uključena neobavezna podešavanja
  voteStyle: { style: "updown" }
};
const result: FlagCommentPublic200Response = await replaceTenantPackage(tenantId, id, replaceTenantPackageBody);

ažurirajPaketNajmoprimca

Parametri

Name	Type	Required
tenantId	string	Da
id	string	Da
updateTenantPackageBody	UpdateTenantPackageBody	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

updateTenantPackage Primjer

Copy

const tenantId: string = 'tenant_9f3b2a';
const id: string = 'pkg_pro_2026';
const updateTenantPackageBody: UpdateTenantPackageBody = {
  name: 'Pro Plan',
  monthlyPriceUsd: 49,
  isActive: true,
  features: ['moderation', 'analytics', 'sso'],
  trialDays: 14 // demonstracija neobaveznog parametra
};
const result: FlagCommentPublic200Response = await updateTenantPackage(tenantId, id, updateTenantPackageBody);

kreirajKorisnikaNajmoprimca

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createTenantUserBody	CreateTenantUserBody	Da

Odgovor

Vraća: CreateTenantUser200Response

Primjer

createTenantUser Primjer

Copy

const tenantId: string = "tenant_7f4a2b";
const createTenantUserBody: CreateTenantUserBody = {
  email: "jane.doe@example.com",
  firstName: "Jane",
  lastName: "Doe",
  role: "commenter",
  approved: true,
  displayName: "Jane D." // neobavezno: pružanje prikaznog imena
};
const result: CreateTenantUser200Response = await createTenantUser(tenantId, createTenantUserBody);
console.log(result);

izbrišiKorisnikaNajmoprimca

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
deleteComments	string	Ne
commentDeleteMode	string	Ne

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer deleteTenantUser

Copy

const tenantId: string = "tenant_8f3a2b1c4d";
const id: string = "user_62a4f9e0b7";
const deleteComments: string = "true";
const commentDeleteMode: string = "permanent";
const result: FlagCommentPublic200Response = await deleteTenantUser(tenantId, id, deleteComments, commentDeleteMode);

dohvatiKorisnikaNajmoprimca

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetTenantUser200Response

Primjer

getTenantUser Primjer

Copy

const tenantId: string = 'tenant_ab12c3';
const id: string = 'user_9f8e7d';
const response: GetTenantUser200Response = await getTenantUser(tenantId, id);
console.log(response);

dohvatiKorisnikeNajmoprimca

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
skip	number	Ne

Odgovor

Vraća: GetTenantUsers200Response

Primjer

Primjer getTenantUsers

Copy

const tenantId: string = 'tenant_7b8f3a2c-9e4d-4f1a';
const skip: number = 50;
const usersResponseDefault: GetTenantUsers200Response = await getTenantUsers(tenantId);
const usersResponsePaged: GetTenantUsers200Response = await getTenantUsers(tenantId, skip);

zamijeniKorisnikaNajmoprimca

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
replaceTenantUserBody	ReplaceTenantUserBody	Da
updateComments	string	Ne

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer replaceTenantUser

Copy

const tenantId: string = "f3b9a2d1-8b4e-4c6a-9f2b-1d5c4e6a7b8c";
const id: string = "user_92f7c3b1";
const replaceTenantUserBody: ReplaceTenantUserBody = {
  externalId: "auth0|1234567890",
  email: "jane.doe@company.com",
  displayName: "Jane Doe",
  roles: ["moderator"],
  metadata: { department: "support" }
};
const updateComments: string = "reassign-comments-to-new-user";
const response: FlagCommentPublic200Response = await replaceTenantUser(tenantId, id, replaceTenantUserBody, updateComments);

pošaljiPoveznicuZaPrijavu

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_0a1b2c3d";
const id: string = "user_984321";
const redirectURL: string = "https://app.acme-corp.com/welcome";
const responseWithRedirect: FlagCommentPublic200Response = await sendLoginLink(tenantId, id, redirectURL);
const responseWithoutRedirect: FlagCommentPublic200Response = await sendLoginLink(tenantId, id);

ažurirajKorisnikaNajmoprimca

Parametri

Ime	Tip	Obavezno
tenantId	string	Da
id	string	Da
updateTenantUserBody	UpdateTenantUserBody	Da
updateComments	string	Ne

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateTenantUser

Copy

const tenantId: string = 'acme-corp';
const userId: string = 'u_72b9f4';
const updateTenantUserBody: UpdateTenantUserBody = {
  email: 'jane.doe@acme.com',
  displayName: 'Jane Doe',
  roles: ['moderator'],
  suspended: false
};
const updateComments: string = 'Promoted to moderator after review of activity and community feedback';
const result: FlagCommentPublic200Response = await updateTenantUser(tenantId, userId, updateTenantUserBody, updateComments);

kreirajNajmoprimca

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createTenantBody	CreateTenantBody	Da

Odgovor

Vraća: CreateTenant200Response

Primjer

Primjer createTenant

Copy

const tenantId: string = 'acme-news-01';
const createTenantBody: CreateTenantBody = {
  name: 'Acme News',
  domainConfiguration: { primaryDomain: 'news.acme.com', redirectHttps: true } as APIDomainConfiguration,
  importedSites: [{ siteId: 'site-92', url: 'https://news.acme.com' }] as ImportedSiteType[],
  billingInfo: { planId: 'business_monthly', contactEmail: 'billing@acme.com' } as BillingInfo
};
const result: CreateTenant200Response = await createTenant(tenantId, createTenantBody);

izbrišiNajmoprimca

Parametri

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

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer deleteTenant

Copy

const tenantId: string = 'tenant_742b9c';
const flagId: string = 'flag_1a2b3c';
const resultWithoutSure: FlagCommentPublic200Response = await deleteTenant(tenantId, flagId);
const sureConfirmation: string = 'confirmed';
const resultWithSure: FlagCommentPublic200Response = await deleteTenant(tenantId, flagId, sureConfirmation);

dohvatiNajmoprimca

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Yes
id	string	Yes

Odgovor

Vraća: GetTenant200Response

Primjer

Primjer getTenant

Copy

const tenantId: string = 'fc_tenant_6b3e2a';
const id: string = 'site_42f1';
const tenantResponse: GetTenant200Response = await getTenant(tenantId, id);
const tenant: APITenant | undefined = tenantResponse.tenant;
const primaryDomain: APIDomainConfiguration | undefined = tenant?.domainConfiguration?.[0];

dohvatiNajmoprimce

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
meta	string	Ne
skip	number	Ne

Odgovor

Vraća: GetTenants200Response

Primjer

Primjer getTenants

Copy

const tenantId: string = "fcom-tenant-8b4f2a1c";
const meta: string = "include=domains,billing&status=active";
const skip: number = 20;
const response: GetTenants200Response = await getTenants(tenantId, meta, skip);
console.log(response);

ažurirajNajmoprimca

Parametri

Name	Type	Required
tenantId	string	Da
id	string	Da
updateTenantBody	UpdateTenantBody	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateTenant

Copy

const tenantId: string = 'tenant_84f12';
const id: string = 'flag_192b';
const updateTenantBody: UpdateTenantBody = {
  name: 'Acme Media',
  billingInfo: { plan: 'enterprise', seats: 25, nextBillingDate: '2026-07-01' },
  apiDomainConfiguration: { primaryDomain: 'comments.acme.com', additionalDomains: ['acme.com'] },
  importedSites: [{ siteUrl: 'https://blog.acme.com', archived: false }], // neobavezno
  commentSettings: { htmlRenderingMode: 'sanitized', deletionMode: 'soft' } // neobavezno
} as UpdateTenantBody;
const result: FlagCommentPublic200Response = await updateTenant(tenantId, id, updateTenantBody);

promijeniStanjeZahtjeva

Parametri

Name	Type	Required
tenantId	string	Da
userId	string	Da
id	string	Da
changeTicketStateBody	ChangeTicketStateBody	Da

Odgovor

Vraća: ChangeTicketState200Response

Primjer

Primjer changeTicketState

Copy

const tenantId: string = 'tenant_8a7d3f4b';
const userId: string = 'user_5d1a9b2c';
const id: string = 'ticket_1024';
const changeTicketStateBody: ChangeTicketStateBody = {
  state: 'closed',
  notifyParticipants: true, // neobavezni parametar
  comment: 'Resolved by support — follow-up not required.'
};
const result: ChangeTicketState200Response = await changeTicketState(tenantId, userId, id, changeTicketStateBody);

kreirajZahtjev

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
userId	string	Da
createTicketBody	CreateTicketBody	Da

Odgovor

Vraća: CreateTicket200Response

Primjer

Primjer createTicket

Copy

const tenantId: string = 'tenant_acme_corp';
const userId: string = 'moderator_jane';
const createTicketBody: CreateTicketBody = {
  subject: 'Mass spam reports on article 789',
  description: 'Multiple identical spam comments posted under article 789. Needs moderation and bulk removal.',
  priority: 'high',
  contactEmail: 'jane@acme-corp.com',
  metadata: { articleId: '789', reportedCount: 12 } // primjer opcionalnih metapodataka
};
const ticket: CreateTicket200Response = await createTicket(tenantId, userId, createTicketBody);

dohvatiZahtjev

Parametri

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

Odgovor

Vraća: GetTicket200Response

Primjer

Primjer getTicket

Copy

const tenantId: string = 'acme-corp';
const ticketId: string = 'TCKT-20250615-42';
const userId: string = 'user_84b2';
const ticketWithUser: GetTicket200Response = await getTicket(tenantId, ticketId, userId);
const ticketWithoutUser: GetTicket200Response = await getTicket(tenantId, ticketId);
console.log(ticketWithUser.id, ticketWithoutUser.id);

dohvatiZahtjeve

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
userId	string	Ne
state	number	Ne
skip	number	Ne
limit	number	Ne

Odgovor

Vraća: GetTickets200Response

Primjer

Primjer getTickets

Copy

const tenantId: string = 'tenant_acme_01';
const userId: string = 'user_87b3';
const state: number = 2;
const skip: number = 0;
const limit: number = 50;
const tickets: GetTickets200Response = await getTickets(tenantId, userId, state, skip, limit);

dohvatiPrijevode

Parametri

Naziv	Tip	Obavezno
namespace	string	Da
component	string	Da
locale	string	Ne
useFullTranslationIds	boolean	Ne

Odgovor

Vraća: GetTranslations200Response

Primjer

Primjer getTranslations

Copy

const namespaceName: string = 'site-ui';
const componentName: string = 'comment-widget';
const locale: string = 'fr-FR';
const useFullTranslationIds: boolean = true;
const translationsWithLocale: GetTranslations200Response = await getTranslations(namespaceName, componentName, locale, useFullTranslationIds);
const translationsDefault: GetTranslations200Response = await getTranslations(namespaceName, componentName);

učitajSliku

Otpremi i promijeni veličinu slike

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
file	Blob	Da
sizePreset	SizePreset	Ne
urlId	string	Ne

Odgovor

Vraća: UploadImageResponse

dohvatiNapredakZnačkePoId

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetUserBadgeProgressById200Response

Primjer

getUserBadgeProgressById Primjer

Copy

const tenantId: string = 'fastcomments-tenant-241';
const badgeId: string = 'user-78b3d-badge-3';
const response: GetUserBadgeProgressById200Response = await getUserBadgeProgressById(tenantId, badgeId);
const progress: UserBadgeProgress | undefined = (response as unknown as { progress?: UserBadgeProgress }).progress;
const percentComplete: number | undefined = progress?.percentage;
console.log('Badge progress percent complete:', percentComplete);

dohvatiNapredakZnačkePoIdKorisnika

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
userId	string	Da

Odgovor

Vraća: GetUserBadgeProgressById200Response

Primjer

Primjer getUserBadgeProgressByUserId

Copy

const tenantId: string = 'acme-inc-tenant-01';
const userId: string = 'user_73c9b2';
const progress: GetUserBadgeProgressById200Response = await getUserBadgeProgressByUserId(tenantId, userId);
async function maybeFetchProgress(tenant: string, user?: string): Promise<GetUserBadgeProgressById200Response | null> {
  if (!user) return null;
  return await getUserBadgeProgressByUserId(tenant, user);
}
const optionalResult: GetUserBadgeProgressById200Response | null = await maybeFetchProgress(tenantId, userId);

dohvatiPopisNapretkaZnačkiKorisnika

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
userId	string	Ne
limit	number	Ne
skip	number	Ne

Odgovor

Vraća: GetUserBadgeProgressList200Response

Primjer

Primjer getUserBadgeProgressList

Copy

const tenantId: string = 'tenant_4f3a2b9c';
const userId: string = 'user_7721d';
const limit: number = 20;
const skip: number = 0;
const result: GetUserBadgeProgressList200Response = await getUserBadgeProgressList(tenantId, userId, limit, skip);

kreirajZnačkuKorisnika

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createUserBadgeParams	CreateUserBadgeParams	Da

Odgovor

Vraća: CreateUserBadge200Response

Primjer

Primjer createUserBadge

Copy

const tenantId: string = "tenant_7f4b2a";
const createUserBadgeParams: CreateUserBadgeParams = {
  code: "top_contributor",
  title: "Top Contributor",
  description: "Awarded for 100 high-quality comments",
  iconUrl: "https://cdn.fastcomments.com/badges/top_contributor.svg",
  isActive: true,
  criteria: { commentsRequired: 100 },
  customConfig: { displayOnProfile: true } // demonstrira neobavezni parametar
};
const result: CreateUserBadge200Response = await createUserBadge(tenantId, createUserBadgeParams);

izbrišiZnačkuKorisnika

Parametri

Name	Type	Required	Description
tenantId	string	Da
id	string	Da

Odgovor

Vraća: UpdateUserBadge200Response

Primjer

Primjer deleteUserBadge

Copy

const tenantId: string = "tenant_8b3f2c7a";
const badgeIdOptional: string | undefined = Math.random() > 0.5 ? "badge_4f9a21" : undefined;
const id: string = badgeIdOptional ?? "badge_backup_01";
const result: UpdateUserBadge200Response = await deleteUserBadge(tenantId, id);

dohvatiZnačkuKorisnika

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetUserBadge200Response

Primjer

Primjer getUserBadge

Copy

(async () => {
  const tenantId: string = 'tenant_6b8f2a1c';
  const id: string = 'badge_9f3d4b2a';
  const response: GetUserBadge200Response = await getUserBadge(tenantId, id);
  const badge: UserBadge | undefined = response.userBadge;
  const badgeName: string | undefined = badge?.name;
  console.log('Retrieved badge name:', badgeName);
})();

dohvatiZnačkeKorisnika

Parametri

Name	Type	Required
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_7f9a12';
const userId: string = 'user_42b7';
const badgeId: string = 'badge_top_contributor';
const type: number = 2;
const displayedOnComments: boolean = true;
const limit: number = 25;
const skip: number = 0;
const badges: GetUserBadges200Response = await getUserBadges(tenantId, userId, badgeId, type, displayedOnComments, limit, skip);

ažurirajZnačkuKorisnika

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
updateUserBadgeParams	UpdateUserBadgeParams	Da

Odgovor

Vraća: UpdateUserBadge200Response

Primjer

Primjer updateUserBadge

Copy

const tenantId: string = "tenant_9a8b7c";
const id: string = "badge_a1b2c3";
const updateUserBadgeParams: UpdateUserBadgeParams = {
  title: "Community Helper",
  description: "Awarded for providing 50 helpful answers",
  iconUrl: "https://cdn.fastcomments.com/badges/community-helper.png",
  isActive: true,
  expiryDate: undefined
};
const result: UpdateUserBadge200Response = await updateUserBadge(tenantId, id, updateUserBadgeParams);

dohvatiBrojObavijestiKorisnika

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Yes
sso	string	No

Odgovor

Vraća: GetUserNotificationCount200Response

Primjer

Primjer getUserNotificationCount

Copy

const tenantId: string = 'tenant_acme_01';
const ssoToken: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.sso_payload.signature';
const notificationCountNoSSO: GetUserNotificationCount200Response = await getUserNotificationCount(tenantId);
const notificationCountWithSSO: GetUserNotificationCount200Response = await getUserNotificationCount(tenantId, ssoToken);

dohvatiObavijestiKorisnika

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
urlId	string	Ne
pageSize	number	Ne
afterId	string	Ne
includeContext	boolean	Ne
afterCreatedAt	number	Ne
unreadOnly	boolean	Ne
dmOnly	boolean	Ne
noDm	boolean	Ne
includeTranslations	boolean	Ne
includeTenantNotifications	boolean	Ne
sso	string	Ne

Odgovor

Vraća: GetUserNotifications200Response

Primjer

getUserNotifications Primjer

Copy

const tenantId: string = "tenant_8271";
const urlId: string = "https://www.news-site.com/articles/2026/06/15/ai-updates";
const pageSize: number = 25;
const afterId: string = "notif_abc123";
const includeContext: boolean = true;
const afterCreatedAt: number = Date.now() - 86_400_000;
const unreadOnly: boolean = true;
const dmOnly: boolean = false;
const noDm: boolean = false;
const includeTranslations: boolean = true;
const includeTenantNotifications: boolean = true;
const sso: string = "sso_token_xyz_987";
const notifications: GetUserNotifications200Response = await getUserNotifications(
  tenantId,
  urlId,
  pageSize,
  afterId,
  includeContext,
  afterCreatedAt,
  unreadOnly,
  dmOnly,
  noDm,
  includeTranslations,
  includeTenantNotifications,
  sso
);

poništiBrojObavijestiKorisnika

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
sso	string	Ne

Odgovor

Vraća: ResetUserNotifications200Response

Primjer

Primjer resetUserNotificationCount

Copy

const tenantId: string = "tenant_8a3f2b6c";
const ssoToken: string = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ1c2VyX2QxMjM0IiwiaWF0IjoxNjI1MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c";
const resetResponseWithSso: ResetUserNotifications200Response = await resetUserNotificationCount(tenantId, ssoToken);
const resetResponseWithoutSso: ResetUserNotifications200Response = await resetUserNotificationCount(tenantId);

poništiObavijestiKorisnika

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
afterId	string	Ne
afterCreatedAt	number	Ne
unreadOnly	boolean	Ne
dmOnly	boolean	Ne
noDm	boolean	Ne
sso	string	Ne

Odgovor

Vraća: ResetUserNotifications200Response

Primjer

Primjer resetUserNotifications

Copy

const tenantId: string = "tenant_9b1f2";
const afterId: string = "notification_0001";
const afterCreatedAt: number = Date.now() - 60 * 60 * 1000; // prije sat vremena
const unreadOnly: boolean = true;
const dmOnly: boolean = false;
const noDm: boolean = false;
const sso: string = "sso_session_7f2d";
const result: ResetUserNotifications200Response = await resetUserNotifications(
  tenantId,
  afterId,
  afterCreatedAt,
  unreadOnly,
  dmOnly,
  noDm,
  sso
);

ažurirajStatusPretplateNaKomentareKorisnika

Omogući ili onemogući obavijesti za određeni komentar.

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
notificationId	string	Da
optedInOrOut	UpdateUserNotificationCommentSubscriptionStatusOptedInOrOutEnum	Da
commentId	string	Da
sso	string	Ne

Odgovor

Vraća: UpdateUserNotificationStatus200Response

Primjer

Primjer updateUserNotificationCommentSubscriptionStatus

Copy

const tenantId: string = 'f3a9c8b0-4d2e-4f8a-9c3b-1234567890ab';
const notificationId: string = '62a1f4d2-8c7b-4e1a-aaa1-abcdef123456';
const commentId: string = '7e4a2b1c-1234-5678-90ab-cdef12345678';
const optedInOrOut: UpdateUserNotificationCommentSubscriptionStatusOptedInOrOutEnum = UpdateUserNotificationCommentSubscriptionStatusOptedInOrOutEnum.OptedIn;
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.ssoPayload.signature';
const response: UpdateUserNotificationStatus200Response = await updateUserNotificationCommentSubscriptionStatus(tenantId, notificationId, optedInOrOut, commentId, sso);

ažurirajStatusPretplateNaStranicuKorisnika

Omogućite ili onemogućite obavijesti za stranicu. Kada su korisnici pretplaćeni na stranicu, obavijesti se stvaraju za nove glavne komentare, kao i

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 updateUserNotificationPageSubscriptionStatus

Copy

const tenantId: string = 'tenant_7f3b2';
const urlId: string = 'article_987';
const url: string = 'https://www.news-site.com/articles/2026/pasta-guide';
const pageTitle: string = 'The Definitive Guide to Cooking Pasta';
const subscribedOrUnsubscribed: UpdateUserNotificationPageSubscriptionStatusSubscribedOrUnsubscribedEnum = UpdateUserNotificationPageSubscriptionStatusSubscribedOrUnsubscribedEnum.Subscribed;
const sso: string = 'sso-token-62b9f1';
const result: UpdateUserNotificationStatus200Response = await updateUserNotificationPageSubscriptionStatus(tenantId, urlId, url, pageTitle, subscribedOrUnsubscribed, sso);

ažurirajStatusObavijestiKorisnika

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
notificationId	string	Da
newStatus	UpdateUserNotificationStatusNewStatusEnum	Da
sso	string	Ne

Odgovor

Vraća: UpdateUserNotificationStatus200Response

Primjer

Primjer updateUserNotificationStatus

Copy

const tenantId: string = 'tenant_5f2a8b9c';
const notificationId: string = 'notif_987654321';
const newStatus: UpdateUserNotificationStatusNewStatusEnum = UpdateUserNotificationStatusNewStatusEnum.Read;
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.payload.signature';
const result: UpdateUserNotificationStatus200Response = await updateUserNotificationStatus(tenantId, notificationId, newStatus, sso);

dohvatiStatusePrisutnostiKorisnika

Parametri

Naziv	Tip	Obvezno
tenantId	string	Da
urlIdWS	string	Da
userIds	string	Da

Odgovor

Vraća: GetUserPresenceStatuses200Response

Primjer

getUserPresenceStatuses Primjer

Copy

const tenantId: string = 'tenant_42';
const urlIdWS: string = 'wss://comments.fastsite.com/ws/tenant_42';
const userIds: string = 'user_9012,user_3478';
const includePresenceMetadata: boolean | undefined = true; // primjer neobaveznog parametra
const presenceStatuses: GetUserPresenceStatuses200Response = await getUserPresenceStatuses(tenantId, urlIdWS, userIds);

pretražiKorisnike

Parametri

Naziv	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 searchUsers

Copy

const tenantId: string = 'tenant_7890';
const urlId: string = 'news/2026-06-15-world-cup-final';
const usernameStartsWith: string = 'mar';
const mentionGroupIds: string[] = ['staff', 'trusted-commenters'];
const sso: string = 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiI0NTY3OCJ9.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c';
const searchSection: SearchUsersSearchSectionEnum = SearchUsersSearchSectionEnum.Commenters;
const response: SearchUsers200Response = await searchUsers(tenantId, urlId, usernameStartsWith, mentionGroupIds, sso, searchSection);

dohvatiKorisnika

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetUser200Response

Primjer

getUser Primjer

Copy

const tenantId: string = 'fastcomments_corp';
const id: string = 'user_9f8b7c6d-5e4a-3b2c-1f0e-123456789abc';
const response: GetUser200Response = await getUser(tenantId, id);
const userEmail: string | undefined = response.user?.email;
const displayName: string | undefined = response.user?.displayName

kreirajGlas

Parametri

Name	Tip	Obavezno
tenantId	string	Da
commentId	string	Da
direction	CreateVoteDirectionEnum	Da
userId	string	Ne
anonUserId	string	Ne

Odgovor

Vraća: VoteComment200Response

Primjer

Primjer createVote

Copy

const tenantId: string = 'fastcomments-tenant-001';
const commentId: string = 'cmt_8f3b2a9d';
const direction: CreateVoteDirectionEnum = CreateVoteDirectionEnum.Up;
const userId: string = 'user_5021';
const anonUserId: string = 'anon_7a9c';
const voteResponse: VoteComment200Response = await createVote(tenantId, commentId, direction, userId, anonUserId);

izbrišiGlas

Parametri

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

Odgovor

Vraća: DeleteCommentVote200Response

Primjer

Primjer deleteVote

Copy

(async () => {
  const tenantId: string = 'tenant_8421';
  const id: string = 'vote_3f9b7c2a';
  const editKey: string = 'edit_7Xk9LpQ';
  const responseWithoutEdit: DeleteCommentVote200Response = await deleteVote(tenantId, id);
  const responseWithEdit: DeleteCommentVote200Response = await deleteVote(tenantId, id, editKey);
  console.log(responseWithoutEdit, responseWithEdit);
})();

dohvatiGlasove

Parametri

Naziv	Tip	Obvezno	Opis
tenantId	string	Da
urlId	string	Da

Odgovor

Vraća: GetVotes200Response

Primjer

Primjer getVotes

Copy

const tenantId: string = 'tenant_7f8e91c2';
const urlId: string = 'https://www.sportsdaily.com/news/2026/06/15/championship-game-recap';
const votes: GetVotes200Response = await getVotes(tenantId, urlId);
console.log(votes);

dohvatiGlasoveZaKorisnika

Parametri

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

Odgovor

Vraća: GetVotesForUser200Response

Primjer

Primjer getVotesForUser

Copy

const tenantId: string = 'tenant_9b8f7c6d';
const urlId: string = 'articles/product-update-2026';
const userId: string = 'user_c12345';
const anonUserId: string = 'anon_7f4e2a';
const votes: GetVotesForUser200Response = await getVotesForUser(tenantId, urlId, userId, anonUserId);

Trebate pomoć?

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

Doprinosi

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

Jezik 🇭🇷 Hrvatski

Početak

API referenca

Dokumentacija

Korištenje

Agregacija

Revizijski zapisi

Blokiraj iz komentara

Provjera blokiranih komentara

Komentari

Komentari za korisnika

Konfiguracije domene

Predlošci e-pošte

Dnevnik događaja

Objave feeda

Prijavi komentar

GIF-ovi

Hashtagi

Moderatori

Brojač obavijesti

Obavijesti

Reakcije stranice

Stranice

Neobrađeni webhook događaji

Konfiguracije pitanja

Rezultati pitanja

Agregacija rezultata pitanja

SSO korisnici

Pretplate

Dnevna upotreba najmoprimca

Paketi najmoprimca

Korisnici najmoprimca

Najmoprimci

Zahtjevi

Prijevodi

Učitaj sliku

Napredak značke korisnika

Značke korisnika

Korisničke obavijesti

Status prisutnosti korisnika

Pretraživanje korisnika

Korisnici

Glasovi

FastComments JavaScript/TypeScript SDK

Repozitorij

Instalacija

API dokumentacija

Potpuna referenca API-ja: docs/api/README.md

Kompatibilnost preglednika i poslužitelja

Korištenje

Korištenje u pregledniku (klijentska strana)

Korištenje na serveru (Node.js)

Uvoz samo tipova

Korištenje pojedinačnih API klasa

Pregledničko okruženje

Serversko okruženje

Javni i zaštićeni API-ji

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

Primjer: Korištenje Default API-ja (samo na strani poslužitelja)

Integracija SSO (jedinstveno prijavljivanje)

Jednostavni SSO (samo na strani poslužitelja)

Sigurni SSO (na strani poslužitelja, preporučeno)

Korištenje SSO iz preglednika (s tokenom generiranim na serveru)

SSO s kreiranjem komentara

Uobičajeni slučajevi upotrebe

Dohvaćanje komentara za stranicu

Stvaranje komentara

Glasanje za komentar

Upravljanje korisnicima (potreban API ključ)

Događaji uživo (ažuriranja u stvarnom vremenu)

Događaji na razini stranice

Pretplata na korisničke događaje

Dobivanje userIdWS

ID-ovi emitiranja

Rukovanje pogreškama

agregacija

Parametri

Odgovor

Primjer

dohvatiRevizijskeZapise