FastComments JavaScript/TypeScript SDK

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

Službeni JavaScript/TypeScript SDK za FastComments API

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 (Single Sign-On)

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

aggregate

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

Parametri

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

Odgovor

Vraća: AggregationResponse

getAuditLogs

Parametri

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

Odgovor

Vraća: GetAuditLogs200Response

blockFromCommentPublic

Parametri

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

Odgovor

Vraća: BlockFromCommentPublic200Response

unBlockCommentPublic

Parametri

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

Odgovor

Vraća: UnBlockCommentPublic200Response

checkedCommentsForBlocked

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
commentIds	string	Da
sso	string	Ne

Odgovor

Vraća: CheckedCommentsForBlocked200Response

blockUserFromComment

Parametri

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

Odgovor

Vraća: BlockFromCommentPublic200Response

createCommentPublic

Parametri

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

Odgovor

Vraća: CreateCommentPublic200Response

deleteComment

Parametri

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

Odgovor

Vraća: DeleteComment200Response

deleteCommentPublic

Parametri

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

Odgovor

Vraća: DeleteCommentPublic200Response

deleteCommentVote

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

flagComment

Parametri

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

Odgovor

Vraća: FlagComment200Response

getComment

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetComment200Response

getComments

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

Odgovor

Vraća: GetComments200Response

getCommentsPublic

req tenantId urlId

Parametri

Naziv	Tip	Obavezno
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

getCommentText

Parametri

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

Odgovor

Vraća: GetCommentText200Response

getCommentVoteUserNames

Parametri

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

Odgovor

Vraća: GetCommentVoteUserNames200Response

lockComment

Parametri

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

Odgovor

Vraća: LockComment200Response

pinComment

Parametri

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

Odgovor

Vraća: PinComment200Response

saveComment

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

saveCommentsBulk

Parametri

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

Odgovor

Vraća: Array<SaveComment200Response

setCommentText

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

unBlockUserFromComment

Parametri

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

Odgovor

Vraća: UnBlockCommentPublic200Response

unFlagComment

Parametri

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

Odgovor

Vraća: FlagComment200Response

unLockComment

Parametri

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

Odgovor

Vraća: LockComment200Response

unPinComment

Parametri

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

Odgovor

Vraća: PinComment200Response

updateComment

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
body	PickAPICommentUpdatableCommentFields	Da
contextUserId	string	Ne
doSpamCheck	boolean	Ne
isLive	boolean	Ne

Odgovor

Vraća: FlagCommentPublic200Response

voteComment

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

addDomainConfig

Parametri

Name	Type	Required	Description
tenantId	string	Da
addDomainConfigParams	AddDomainConfigParams	Da

Odgovor

Vraća: AddDomainConfig200Response

deleteDomainConfig

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
domain	string	Da

Odgovor

Vraća: DeleteDomainConfig200Response

getDomainConfig

Parametri

Name	Type	Required	Description
tenantId	string	Da
domain	string	Da

Odgovor

Vraća: GetDomainConfig200Response

getDomainConfigs

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da

Odgovor

Vraća: GetDomainConfigs200Response

patchDomainConfig

Parametri

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

Odgovor

Vraća: GetDomainConfig200Response

putDomainConfig

Parametri

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

Odgovor

Vraća: GetDomainConfig200Response

createEmailTemplate

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createEmailTemplateBody	CreateEmailTemplateBody	Da

Odgovor

Vraća: CreateEmailTemplate200Response

Primjer

createEmailTemplate Primjer

Copy

const tenantId: string = "tenant_7a9f2b3d";
const createEmailTemplateBody: CreateEmailTemplateBody = {
  name: "Comment Notification",
  subject: "New comment on your article: ",
  htmlBody: "<p> left a comment:</p><blockquote></blockquote>",
  enabled: true,
  defaultLocale: "en-US",
  metadata: { createdBy: "admin@example.com", purpose: "notify_comment" } // neobavezni dodatni podaci
};
const result: CreateEmailTemplate200Response = await createEmailTemplate(tenantId, createEmailTemplateBody);

deleteEmailTemplate

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer deleteEmailTemplate

Copy

const tenantId: string = "tenant_4b2f6a-4b2f6a2d";
const templateId: string = "email_template_9f8b7c3e";
const result: FlagCommentPublic200Response = await deleteEmailTemplate(tenantId, templateId);
const status: APIStatus | undefined = result?.status

deleteEmailTemplateRenderError

Parametri

Naziv	Tip	Obavezno
tenantId	string	Yes
id	string	Yes
errorId	string	Yes

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer deleteEmailTemplateRenderError

Copy

const tenantId: string = "tenant_8f3b2a9c";
const id: string = "template_4a1c9f7e";
const errorId: string = "err_20260112_abc123";
const result: FlagCommentPublic200Response = await deleteEmailTemplateRenderError(tenantId, id, errorId);

getEmailTemplate

Parametri

Name	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetEmailTemplate200Response

Primjer

Primjer getEmailTemplate

Copy

(async () => {
  const tenantId: string = 'acme-enterprises-123';
  const id: string = 'welcome-email-template-v2';
  const locale: string | undefined = 'en-US'; // primjer neobaveznog parametra
  const template: GetEmailTemplate200Response = await getEmailTemplate(tenantId, id);
  console.log(template, locale);
})();

getEmailTemplateDefinitions

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da

Odgovor

Vraća: GetEmailTemplateDefinitions200Response

Primjer

Primjer getEmailTemplateDefinitions

Copy

const tenantId: string = 'acme-enterprises-78f2';
const emailTemplates: GetEmailTemplateDefinitions200Response = await getEmailTemplateDefinitions(tenantId);

getEmailTemplateRenderErrors

Parametri

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

Odgovor

Vraća: GetEmailTemplateRenderErrors200Response

Primjer

Primjer getEmailTemplateRenderErrors

Copy

const tenantId: string = "tenant_7b3f2a9c";
const id: string = "tmpl_4f1b2c9e";
const skip: number = 25;
const result: GetEmailTemplateRenderErrors200Response = await getEmailTemplateRenderErrors(tenantId, id, skip);

getEmailTemplates

Parametri

Ime	Tip	Obavezno	Opis
tenantId	string	Da
skip	number	Ne

Odgovor

Vraća: GetEmailTemplates200Response

Primjer

Primjer getEmailTemplates

Copy

const tenantId: string = 'tenant_8f4d2b7c';
const responseWithoutSkip: GetEmailTemplates200Response = await getEmailTemplates(tenantId);
const skip: number = 20;
const responseWithSkip: GetEmailTemplates200Response = await getEmailTemplates(tenantId, skip);

renderEmailTemplate

Parametri

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

Odgovor

Vraća: RenderEmailTemplate200Response

Primjer

Primjer renderEmailTemplate

Copy

const tenantId: string = 'acme-corp-7f3';
const renderEmailTemplateBody: RenderEmailTemplateBody = {
  templateId: 'new-comment-notification',
  recipientEmail: 'jane.doe@acme.com',
  variables: {
    commenterName: 'Samir Patel',
    commentText: 'I found this article really helpful — thanks for sharing!',
    threadUrl: 'https://acme.com/blog/123#comments'
  },
  includeUnsubscribeLink: true
};
const locale: string = 'en-US';
const response: RenderEmailTemplate200Response = await renderEmailTemplate(tenantId, renderEmailTemplateBody, locale);

updateEmailTemplate

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-tenant-01';
const id: string = 'email_tpl_42b7a9';
const updateEmailTemplateBody: UpdateEmailTemplateBody = {
  name: 'Comment Flag Notification',
  subject: 'A comment was flagged on acme.com',
  html: '<p>A comment by  was flagged. Review at </p>',
  replyTo: 'noreply@acme.com', // prikazano neobavezno polje
  enabled: true,
  customConfig: { priority: 'high' } // neobavezni prilagođeni parametri
};
const response: FlagCommentPublic200Response = await updateEmailTemplate(tenantId, id, updateEmailTemplateBody);

getEventLog

req tenantId urlId userIdWS

Parametri

Ime	Tip	Obavezno
tenantId	string	Da
urlId	string	Da
userIdWS	string	Da
startTime	number	Da
endTime	number	Da

Odgovor

Vraća: GetEventLog200Response

getGlobalEventLog

req tenantId urlId userIdWS

Parametri

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

Odgovor

Vraća: GetEventLog200Response

createFeedPost

Parametri

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

Odgovor

Vraća: CreateFeedPost200Response

createFeedPostPublic

Parametri

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

Odgovor

Vraća: CreateFeedPostPublic200Response

deleteFeedPostPublic

Parametri

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

Odgovor

Vraća: DeleteFeedPostPublic200Response

getFeedPosts

req tenantId afterId

Parametri

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

Odgovor

Vraća: GetFeedPosts200Response

getFeedPostsPublic

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

getFeedPostsStats

Parametri

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

Odgovor

Vraća: GetFeedPostsStats200Response

getUserReactsPublic

Parametri

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

Odgovor

Vraća: GetUserReactsPublic200Response

reactFeedPostPublic

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

updateFeedPost

Parametri

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

Odgovor

Vraća: FlagCommentPublic200Response

updateFeedPostPublic

Parametri

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

Odgovor

Vraća: CreateFeedPostPublic200Response

flagCommentPublic

Parametri

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

Odgovor

Vraća: FlagCommentPublic200Response

addHashTag

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Ne
createHashTagBody	CreateHashTagBody	Ne

Odgovor

Vraća: AddHashTag200Response

Primjer

addHashTag Primjer

Copy

const tenantId: string = 'tenant_7b2f6c2b';
const createBody: CreateHashTagBody = {
  tag: 'feature-request',
  label: 'Feature Request',
  description: 'Requests for new functionality in the web client',
  isActive: true,
  visibility: 'public',
  allowedDomains: ['example.com', 'internal.example.com']
};
const result: AddHashTag200Response = await addHashTag(tenantId, createBody);
const resultWithoutTenant: AddHashTag200Response = await addHashTag(undefined, {
  tag: 'bug',
  label: 'Bug',
  description: 'Use for reproducible bugs reported by users',
  isActive: true,
  visibility: 'public'
});

addHashTagsBulk

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Ne
bulkCreateHashTagsBody	BulkCreateHashTagsBody	Ne

Odgovor

Vraća: AddHashTagsBulk200Response

Primjer

Primjer addHashTagsBulk

Copy

(async () => {
  const tenantId: string = 'tenant_3f2b9a';
  const bulkCreateHashTagsBody: BulkCreateHashTagsBody = {
    tags: [
      { name: 'performance', description: 'Comments about site performance', visibleToModeratorsOnly: false },
      { name: 'feature-request', description: 'Requests for new features', visibleToModeratorsOnly: true }
    ]
  };
  const result: AddHashTagsBulk200Response = await addHashTagsBulk(tenantId, bulkCreateHashTagsBody);
  const resultWithNoTenant: AddHashTagsBulk200Response = await addHashTagsBulk(undefined, bulkCreateHashTagsBody);
  console.log(result, resultWithNoTenant);
})();

deleteHashTag

Parametri

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

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

deleteHashTag Primjer

Copy

const tag: string = 'breaking-news';
const tenantId: string = 'tenant_42';
const deleteReq: DeleteHashTagRequest = { removedBy: 'moderator_jane', reason: 'off-topic for this community', deleteAssociatedComments: true } as DeleteHashTagRequest;
const result: FlagCommentPublic200Response = await deleteHashTag(tag, tenantId, deleteReq);

getHashTags

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
page	number	Ne

Odgovor

Vraća: GetHashTags200Response

Primjer

getHashTags Primjer

Copy

(async () => {
  const tenantId: string = "acme-corp-7a9f";
  const tagsPage1: GetHashTags200Response = await getHashTags(tenantId);
  const tagsPage2: GetHashTags200Response = await getHashTags(tenantId, 2);
  console.log(tagsPage1, tagsPage2);
})();

patchHashTag

Parametri

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

Odgovor

Vraća: PatchHashTag200Response

Primjer

patchHashTag Primjer

Copy

const tag: string = 'release-2026';
const tenantId: string = 'tenant_42';
const updateHashTagBody: UpdateHashTagBody = {
  displayName: 'Release 2026',
  description: 'Discussions and notes for the 2026 product release',
  isActive: true
};
const result: PatchHashTag200Response = await patchHashTag(tag, tenantId, updateHashTagBody);

createModerator

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createModeratorBody	CreateModeratorBody	Da

Odgovor

Vraća: CreateModerator200Response

Primjer

Primjer createModerator

Copy

const tenantId: string = "tenant_prod_us-east_01";
const createModeratorBody: CreateModeratorBody = {
  email: "maria.lopez+mod@fastcompany.com",
  username: "mlopez_mod",
  displayName: "Maria Lopez",
  roles: ["content_moderator"],
  notifyOnReports: true,
  metadata: { region: "us-east", team: "community" }
};
const result: CreateModerator200Response = await createModerator(tenantId, createModeratorBody);

deleteModerator

Parametri

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

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

deleteModerator Primjer

Copy

const tenantId: string = 'acme-tenant-987';
const moderatorId: string = 'mod-78b2c9a4-3f1e-4d6a';
const sendEmail: string = 'true';
const result: FlagCommentPublic200Response = await deleteModerator(tenantId, moderatorId, sendEmail);

getModerator

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetModerator200Response

Primjer

Primjer getModerator

Copy

const tenantId: string = "tenant_eu_4f8d2b9e";
const maybeModeratorId: string | undefined = "mod_91c3b7a2"; // neobavezni izvor (može biti undefined)
const moderator: GetModerator200Response = await getModerator(tenantId, maybeModeratorId!);

getModerators

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
skip	number	Ne

Odgovor

Vraća: GetModerators200Response

Primjer

Primjer getModerators

Copy

const tenantId: string = "tenant_corp_7f9b2a";
const moderatorsPage1: GetModerators200Response = await getModerators(tenantId);
const skip: number = 50;
const moderatorsPage2: GetModerators200Response = await getModerators(tenantId, skip);

sendInvite

Parametri

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

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

sendInvite Primjer

Copy

const tenantId: string = 'acme-tenant-004';
const id: string = 'comment_9b7f3a2c';
const fromName: string = 'María Hernández';
const response: FlagCommentPublic200Response = await sendInvite(tenantId, id, fromName);

updateModerator

Parametri

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

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateModerator

Copy

const tenantId: string = '4f8a9c2e-3b6d-4d9e-8c2f-1a2b3c4d5e6f';
const id: string = 'mod_92a7c4';
const updateModeratorBodyMinimal: UpdateModeratorBody = { displayName: 'Sophia Patel' };
const updateModeratorBodyWithOptional: UpdateModeratorBody = {
  displayName: 'Sophia Patel',
  email: 'sophia.patel@newsroom.example',
  permissions: ['remove_comments', 'ban_user'],
  notifyOnFlag: true // primjer neobaveznog parametra
};
const result: FlagCommentPublic200Response = await updateModerator(tenantId, id, updateModeratorBodyWithOptional);

deleteNotificationCount

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer deleteNotificationCount

Copy

const tenantId: string = 'tenant_7f3a1b2c4d9e';
const notificationId: string = 'notif_8c9d0a1b2f3e4b7';
const result: FlagCommentPublic200Response = await deleteNotificationCount(tenantId, notificationId);

getCachedNotificationCount

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetCachedNotificationCount200Response

Primjer

getCachedNotificationCount Primjer

Copy

const tenantId: string = 'acme-tenant-01';
const baseNotificationId: string = 'notif-000123';
const idSuffix: string | undefined = undefined; // primjer neobaveznog parametra
const notificationId: string = idSuffix ? `${baseNotificationId}-${idSuffix}` : baseNotificationId;
const result: GetCachedNotificationCount200Response = await getCachedNotificationCount(tenantId, notificationId);
console.log(result);

getNotificationCount

Parametri

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

Odgovor

Vraća: GetNotificationCount200Response

Primjer

Primjer getNotificationCount

Copy

const tenantId: string = 'tenant_8a9b7c';
const userId: string = 'user_42b3c';
const urlId: string = 'https://blog.example.com/posts/introducing-new-editor';
const fromCommentId: string | undefined = undefined;
const viewed: boolean = false;
const type: string = 'mention';
const result: GetNotificationCount200Response = await getNotificationCount(tenantId, userId, urlId, fromCommentId, viewed, type);

getNotifications

Parametri

Name	Type	Required
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

getNotifications Primjer

Copy

(async () => {
  const tenantId: string = 'tenant_8f3b1a2c';
  const userId: string = 'user_42';
  const urlId: string = 'https://news.example.com/articles/2026/01/11/comment-thread';
  const fromCommentId: string = 'cmt_9a7b';
  const viewed: boolean = false;
  const type: string = 'mention';
  const skip: number = 0;
  const response: GetNotifications200Response = await getNotifications(tenantId, userId, urlId, fromCommentId, viewed, type, skip);
  console.log(response);
})();

updateNotification

Parametri

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

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateNotification

Copy

const tenantId: string = "tenant_86a7b3";
const id: string = "notif_20260112_01";
const userId: string = "moderator_42";
const updateNotificationBody: UpdateNotificationBody = {
  name: "Flagged comment alert",
  enabled: true,
  channels: ["email"],
  recipients: ["mod-team@news-site.com"],
  threshold: 1
};
(async () => {
  const result: FlagCommentPublic200Response = await updateNotification(tenantId, id, updateNotificationBody, userId);
  console.log(result);
})();

addPage

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createAPIPageData	CreateAPIPageData	Da

Odgovor

Vraća: AddPageAPIResponse

deletePage

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: DeletePageAPIResponse

getPageByURLId

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
urlId	string	Da

Odgovor

Vraća: GetPageByURLIdAPIResponse

getPages

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da

Odgovor

Vraća: GetPagesAPIResponse

patchPage

Parametri

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

Odgovor

Vraća: PatchPageAPIResponse

deletePendingWebhookEvent

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

deletePendingWebhookEvent Primjer

Copy

const tenantId: string = 'tenant_7f4e2b';
const pendingEventId: string = '9f7b6a8c-3b2a-4c0d-a8e5-1234567890ab';
const result: FlagCommentPublic200Response = await deletePendingWebhookEvent(tenantId, pendingEventId);
console.log(result);

getPendingWebhookEventCount

Parametri

Ime	Tip	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

(async () => {
  const tenantId: string = 'tenant_9c3b2b';
  const commentId: string = 'cmt_f4a1b2';
  const externalId: string = 'ext-789';
  const eventType: string = 'comment.created';
  const type: string = 'delivery';
  const domain: string = 'app.example.com';
  const attemptCountGT: number = 2;
  const result: GetPendingWebhookEventCount200Response = await getPendingWebhookEventCount(
    tenantId,
    commentId,
    externalId,
    eventType,
    type,
    domain,
    attemptCountGT
  );
  console.log(result);
})();

getPendingWebhookEvents

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

Primjer getPendingWebhookEvents

Copy

const tenantId: string = "tenant_78b2f1";
const commentId: string = "cmt_0042";
const eventType: string = "comment.created";
const domain: string = "blog.example.com";
const attemptCountGT: number = 1;
const skip: number = 0;
const pending: GetPendingWebhookEvents200Response = await getPendingWebhookEvents(
  tenantId,
  commentId,
  undefined, // externalId (vanjski ID)
  eventType,
  undefined, // type (vrsta)
  domain,
  attemptCountGT,
  skip
);

createQuestionConfig

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createQuestionConfigBody	CreateQuestionConfigBody	Da

Odgovor

Vraća: CreateQuestionConfig200Response

Primjer

createQuestionConfig Primjer

Copy

const tenantId: string = "tenant_live_7f8b3c2a";
const customOptions: QuestionConfigCustomOptionsInner[] = [
  { value: "under18", label: "Under 18" },
  { value: "18-24", label: "18-24" },
  { value: "25-34", label: "25-34", defaultSelected: true }
];
const createQuestionConfigBody: CreateQuestionConfigBody = {
  key: "age_range",
  label: "What is your age range?",
  required: false, // neobavezno: pokaži izostavljanje nasuprot uključivanja neobaveznih polja
  renderingType: QuestionRenderingType.Dropdown,
  options: customOptions,
  whenSave: QuestionWhenSave.Always
};
const result: CreateQuestionConfig200Response = await createQuestionConfig(tenantId, createQuestionConfigBody);

deleteQuestionConfig

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Yes
id	string	Yes

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer deleteQuestionConfig

Copy

async function deleteIfPresent(tenantId: string, id?: string): Promise<FlagCommentPublic200Response | null> {
  if (!id) return null;
  const result: FlagCommentPublic200Response = await deleteQuestionConfig(tenantId, id);
  return result;
}
const tenantId: string = 'tenant_acme_001';
const optionalConfigId: string | undefined = 'qcfg_20260112_01';
(async (): Promise<void> => {
  const deleted: FlagCommentPublic200Response | null = await deleteIfPresent(tenantId, optionalConfigId);
  void deleted;
})();

getQuestionConfig

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-2026-01-12-01';
const result: GetQuestionConfig200Response = await getQuestionConfig(tenantId, questionId);
function summarizeConfig(cfg: GetQuestionConfig200Response, includeMetadata?: boolean): QuestionConfig | undefined {
  // includeMetadata je neobavezno; implementacija je izostavljena radi sažetosti
  return undefined;
}
const summarizedWithMeta: QuestionConfig | undefined = summarizeConfig(result, true);
const summarizedDefault: QuestionConfig | undefined = summarizeConfig(result);

getQuestionConfigs

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
skip	number	Ne

Odgovor

Vraća: GetQuestionConfigs200Response

Primjer

Primjer getQuestionConfigs

Copy

const tenantId: string = 'tenant-42a7b9';
const firstPage: GetQuestionConfigs200Response = await getQuestionConfigs(tenantId);
const secondPage: GetQuestionConfigs200Response = await getQuestionConfigs(tenantId, 50);

updateQuestionConfig

Parametri

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

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateQuestionConfig

Copy

const tenantId: string = 'tenant-82b3a';
const id: string = 'qst-20260112';
const updateQuestionConfigBody: UpdateQuestionConfigBody = { label: 'Age verification', required: true, renderingType: 'singleChoice', customOptions: [{ value: '18-24', label: '18–24' }] } as UpdateQuestionConfigBody;
const result: FlagCommentPublic200Response = await updateQuestionConfig(tenantId, id, updateQuestionConfigBody);

createQuestionResult

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createQuestionResultBody	CreateQuestionResultBody	Da

Odgovor

Vraća: CreateQuestionResult200Response

Primjer

Primjer createQuestionResult

Copy

const tenantId: string = "fc_tenant_7a3c_us-east-1";
const metaItem: MetaItem = { key: "referrer", value: "/blog/how-to-comment" };
const createQuestionResultBody: CreateQuestionResultBody = {
  questionId: "q_42",
  commenterId: "user_1984",
  answer: "yes",
  score: 4,
  meta: [metaItem] // demonstracija opcionalnih metapodataka
} as CreateQuestionResultBody;
const result: CreateQuestionResult200Response = await createQuestionResult(tenantId, createQuestionResultBody);

deleteQuestionResult

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer deleteQuestionResult

Copy

const tenantId: string = 'acme-tenant-01';
const questionResultId: string = '6f1a2b3c-4d5e-6789-abcd-ef0123456789';
const deletedResult: FlagCommentPublic200Response = await deleteQuestionResult(tenantId, questionResultId);
console.log(deletedResult);

getQuestionResult

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetQuestionResult200Response

Primjer

Primjer getQuestionResult

Copy

const tenantId: string = "3fa85f64-5717-4562-b3fc-2c963f66afa6";
const questionId: string = "question_72f1b9c3a4";
const result: GetQuestionResult200Response = await getQuestionResult(tenantId, questionId);
console.log(result);

getQuestionResults

Parametri

Name	Type	Required
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 = 'tenant_42';
const urlId: string = 'news/2025/fastcomments-release';
const userId: string = 'user_8b7f3c';
const startDate: string = '2025-01-01T00:00:00Z';
const questionIds: string = 'q123,q124';
const skip: number = 20;
const result: GetQuestionResults200Response = await getQuestionResults(tenantId, urlId, userId, startDate, undefined, questionIds, skip);

updateQuestionResult

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_84f2b9';
const id: string = 'question_3a7c1d';
const updateQuestionResultBody: UpdateQuestionResultBody = {
  result: { verdict: 'helpful', confidence: 0.92 },
  reviewer: { id: 'mod_102', name: 'Aisha Rahman' },
  notifyUser: true // neobavezni parametar uključen
};
const response: FlagCommentPublic200Response = await updateQuestionResult(tenantId, id, updateQuestionResultBody);

aggregateQuestionResults

Parametri

Name	Type	Obvezno
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

bulkAggregateQuestionResults

Parametri

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

Odgovor

Vraća: BulkAggregateQuestionResults200Response

combineCommentsWithQuestionResults

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

addSSOUser

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createAPISSOUserData	CreateAPISSOUserData	Da

Odgovor

Vraća: AddSSOUserAPIResponse

deleteSSOUser

Parametri

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

Odgovor

Vraća: DeleteSSOUserAPIResponse

getSSOUserByEmail

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
email	string	Da

Odgovor

Vraća: GetSSOUserByEmailAPIResponse

getSSOUserById

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetSSOUserByIdAPIResponse

getSSOUsers

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
skip	number	Ne

Odgovor

Vraća: GetSSOUsers200Response

patchSSOUser

Parametri

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

Odgovor

Vraća: PatchSSOUserAPIResponse

putSSOUser

Parametri

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

Odgovor

Vraća: PutSSOUserAPIResponse

createSubscription

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createAPIUserSubscriptionData	CreateAPIUserSubscriptionData	Da

Odgovor

Vraća: CreateSubscriptionAPIResponse

deleteSubscription

Parametri

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

Odgovor

Vraća: DeleteSubscriptionAPIResponse

getSubscriptions

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
userId	string	Ne

Odgovor

Vraća: GetSubscriptionsAPIResponse

getTenantDailyUsages

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
yearNumber	number	Ne
monthNumber	number	Ne
dayNumber	number	Ne
skip	number	Ne

Odgovor

Vraća: GetTenantDailyUsages200Response

Primjer

Primjer getTenantDailyUsages

Copy

const tenantId: string = "tenant_89f3c2-prod";
const yearNumber: number = 2026;
const monthNumber: number = 1;
const skip: number = 0;
const usages: GetTenantDailyUsages200Response = await getTenantDailyUsages(tenantId, yearNumber, monthNumber, undefined, skip);

createTenantPackage

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createTenantPackageBody	CreateTenantPackageBody	Da

Odgovor

Vraća: CreateTenantPackage200Response

Primjer

Primjer createTenantPackage

Copy

const tenantId: string = "tenant_7f3b1a9c";
const tenantPackage: TenantPackage = { id: "pkg_001", name: "Premium Plan", seats: 100 };
const customConfig: CustomConfigParameters = { enableImages: true, maxImageSizeMb: 10 };
const createTenantPackageBody: CreateTenantPackageBody = {
  packageName: "Premium Plus",
  tenantPackage,
  customConfig,
  notes: "Enable advanced moderation and image uploads" // primjer neobaveznog parametra
};
const result: CreateTenantPackage200Response = await createTenantPackage(tenantId, createTenantPackageBody);

deleteTenantPackage

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer za deleteTenantPackage

Copy

const tenantId: string = 'fc-tenant-8a9c2b';
const packageId: string = 'pkg-47f3c9';
const result: FlagCommentPublic200Response = await deleteTenantPackage(tenantId, packageId);

getTenantPackage

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetTenantPackage200Response

Primjer

Primjer getTenantPackage

Copy

const tenantId: string = 'tenant_westus_01';
const packageId: string = 'pkg_premium_annual_2026';
interface FetchOptions { includeArchived?: boolean }
const options: FetchOptions = { includeArchived: false };
const result: GetTenantPackage200Response = await getTenantPackage(tenantId, packageId);

getTenantPackages

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
skip	number	Ne

Odgovor

Vraća: GetTenantPackages200Response

Primjer

getTenantPackages Primjer

Copy

const tenantId: string = 'tenant_4f3a9c2d';
const skip: number = 25;
const packagesResponse: GetTenantPackages200Response = await getTenantPackages(tenantId);
const pagedPackagesResponse: GetTenantPackages200Response = await getTenantPackages(tenantId, skip);

replaceTenantPackage

Parametri

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

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer replaceTenantPackage

Copy

const tenantId: string = 'tenant-9b72f2';
const packageId: string = 'pkg-prod-v2';
const replaceTenantPackageBody: ReplaceTenantPackageBody = {
  name: 'Premium Moderation Bundle',
  enabled: true,
  maxModerators: 4,
  // opcionalna polja poput "notes" ili "trialExpiry" su namjerno izostavljena ovdje
} as ReplaceTenantPackageBody;
const result: FlagCommentPublic200Response = await replaceTenantPackage(
  tenantId,
  packageId,
  replaceTenantPackageBody
);

updateTenantPackage

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
updateTenantPackageBody	UpdateTenantPackageBody	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

updateTenantPackage Primjer

Copy

const tenantId: string = 'tenant_8a4f1c9b';
const packageId: string = 'pkg_premium_v2';
const customConfig: CustomConfigParameters = { enableRichText: true, maxImagesPerComment: 5 };
const updateTenantPackageBody: UpdateTenantPackageBody = {
  name: 'Premium Moderation Package',
  enabled: true,
  description: 'Adds advanced spam rules, image moderation and priority support',
  customConfigParameters: customConfig
};
const result: FlagCommentPublic200Response = await updateTenantPackage(tenantId, packageId, updateTenantPackageBody);

createTenantUser

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createTenantUserBody	CreateTenantUserBody	Da

Odgovor

Vraća: CreateTenantUser200Response

Primjer

Primjer createTenantUser

Copy

const tenantId: string = "tenant_9a8c7e4b";
const createTenantUserBody: CreateTenantUserBody = {
  email: "julia.smith@acme-corp.com",
  displayName: "Julia Smith",
  role: "moderator",
  password: "Str0ngP@ssword!23",
  sendInviteEmail: true, // demonstracija neobaveznog parametra
  locale: "en-US",
  metadata: { department: "Customer Success" }
};
const result: CreateTenantUser200Response = await createTenantUser(tenantId, createTenantUserBody);

deleteTenantUser

Parametri

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

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

deleteTenantUser Primjer

Copy

const tenantId: string = 'tenant_8f3b2a9c';
const id: string = 'user_4e5f6a7b';
const deleteComments: string = 'true';
const commentDeleteMode: string = 'hard';
const result: FlagCommentPublic200Response = await deleteTenantUser(tenantId, id, deleteComments, commentDeleteMode);

getTenantUser

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetTenantUser200Response

Primjer

Primjer getTenantUser

Copy

const tenantId: string = "tenant_9f7d4b2a-1c3e";
const id: string = "user_6a12b3c4d5";
const includeProfile: boolean | undefined = true; // primjer neobaveznog parametra
const response: GetTenantUser200Response = await getTenantUser(tenantId, id);
console.log("Tenant user fetched", response);

getTenantUsers

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
skip	number	Ne

Odgovor

Vraća: GetTenantUsers200Response

Example

Primjer getTenantUsers

Copy

const tenantId: string = 'tenant_8f3b2c1a';
const skip: number = 50;
const firstPage: GetTenantUsers200Response = await getTenantUsers(tenantId);
const nextPage: GetTenantUsers200Response = await getTenantUsers(tenantId, skip);

replaceTenantUser

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 = "tenant_5f8b9a";
const id: string = "user_92bf21";
const replaceTenantUserBody: ReplaceTenantUserBody = {
  email: "jane.doe@acme-corp.com",
  displayName: "Jane Doe",
  externalId: "acme|12345",
  roles: ["commenter", "moderator"],
  isActive: true,
  metadata: { team: "product", location: "NYC" }
};
const updateComments: string = "Update historical comments to reflect new display name";
const result: FlagCommentPublic200Response = await replaceTenantUser(tenantId, id, replaceTenantUserBody, updateComments);

sendLoginLink

Parametri

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

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer sendLoginLink

Copy

const tenantId: string = 'tenant_acme_01';
const id: string = 'user_9f3b2a';
const redirectURL: string = 'https://app.example.com/onboard?source=login-email';
const result: FlagCommentPublic200Response = await sendLoginLink(tenantId, id, redirectURL);

updateTenantUser

Parametri

Naziv	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 = 'tenant_84f3b2';
const id: string = 'user_7a9d1c';
const updateComments: string = 'Promoted to moderator and updated contact email';
const updateTenantUserBody: UpdateTenantUserBody = {
  email: 'jane.doe+mod@example.com',
  displayName: 'Jane D.',
  roles: ['moderator'],
  isBanned: false,
  metadata: { department: 'community' }
};
const result: FlagCommentPublic200Response = await updateTenantUser(tenantId, id, updateTenantUserBody, updateComments);

createTenant

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
createTenantBody	CreateTenantBody	Da

Odgovor

Vraća: CreateTenant200Response

Primjer

Primjer createTenant

Copy

const tenantId: string = "acme-corporation";
const billing: BillingInfo = { planId: "pro", billingContactEmail: "finance@acme-corp.com", currency: "USD" };
const domainConfig: APIDomainConfiguration = { primaryDomain: "comments.acme-corp.com", allowedDomains: ["acme-corp.com", "www.acme-corp.com"], enforceHttps: true };
const importedSites: ImportedSiteType[] = [{ siteId: "site-001", url: "https://blog.acme-corp.com", name: "Acme Blog" }]; // neobavezno
const createBody: CreateTenantBody = { tenantName: "Acme Corporation", adminEmail: "admin@acme-corp.com", billingInfo: billing, domainConfiguration: domainConfig, importedSites, enableModeration: true };
const response: CreateTenant200Response = await createTenant(tenantId, createBody);

deleteTenant

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_7b3f1a9e";
const id: string = "flag_9c4d2b1a";
const sure: string = "yes_confirm_delete";
const result: FlagCommentPublic200Response = await deleteTenant(tenantId, id, sure);
console.log(result);

getTenant

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetTenant200Response

Primjer

Primjer getTenant

Copy

const tenantId: string = "tenant_acme_corp";
const id: string = "f47ac10b-58cc-4372-a567-0e02b2c3d479";
interface GetOptions { includeDeleted?: boolean; locale?: string; }
const options: GetOptions = { locale: "en-US" };
const result: GetTenant200Response = await getTenant(tenantId, id);

getTenants

Parametri

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

Odgovor

Vraća: GetTenants200Response

Primjer

Primjer getTenants

Copy

(async () => {
  const tenantId: string = 'tenant_9f2d1b7c';
  const meta: string = 'include=domains,billing,customConfig';
  const skip: number = 20;
  const response: GetTenants200Response = await getTenants(tenantId, meta, skip);
  console.log(response);
})();

updateTenant

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
id	string	Da
updateTenantBody	UpdateTenantBody	Da

Odgovor

Vraća: FlagCommentPublic200Response

Primjer

Primjer updateTenant

Copy

const tenantId: string = "tenant_01H4ZQ7KABCD";
const id: string = "site_9f8e7d6c";
const apiDomainConfiguration: APIDomainConfiguration = {
  primaryDomain: "comments.acme.com",
  allowSubdomains: true
};
const billingInfo: BillingInfo = {
  planName: "Business",
  billingContactEmail: "billing@acme.com",
  seats: 25
};
const updateTenantBody: UpdateTenantBody = {
  displayName: "Acme Corporation Comments",
  apiDomainConfiguration,
  billingInfo, // neobavezni parametar (prikazan)
  enableModeration: true
};
const result: FlagCommentPublic200Response = await updateTenant(tenantId, id, updateTenantBody);

uploadImage

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

getUserBadgeProgressById

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetUserBadgeProgressById200Response

getUserBadgeProgressByUserId

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
userId	string	Da

Odgovor

Vraća: GetUserBadgeProgressById200Response

getUserBadgeProgressList

Parametri

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

Odgovor

Vraća: GetUserBadgeProgressList200Response

createUserBadge

Parametri

Ime	Tip	Obavezno	Opis
tenantId	string	Da
createUserBadgeParams	CreateUserBadgeParams	Da

Odgovor

Vraća: CreateUserBadge200Response

deleteUserBadge

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: UpdateUserBadge200Response

getUserBadge

Parametri

Naziv	Tip	Obvezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetUserBadge200Response

getUserBadges

Parametri

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

Odgovor

Vraća: GetUserBadges200Response

updateUserBadge

Parametri

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

Odgovor

Vraća: UpdateUserBadge200Response

getUserNotificationCount

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
sso	string	Ne

Odgovor

Vraća: GetUserNotificationCount200Response

getUserNotifications

Parametri

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

Odgovor

Vraća: GetUserNotifications200Response

resetUserNotificationCount

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
sso	string	Ne

Odgovor

Vraća: ResetUserNotifications200Response

resetUserNotifications

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

updateUserNotificationCommentSubscriptionStatus

Omogućite ili onemogućite 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

updateUserNotificationPageSubscriptionStatus

Omogućite ili onemogućite obavijesti za stranicu. Kad su korisnici pretplaćeni na stranicu, obavijesti se stvaraju za nove korijenske komentare, i također

Parameters

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

updateUserNotificationStatus

Parametri

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

Odgovor

Vraća: UpdateUserNotificationStatus200Response

getUserPresenceStatuses

Parametri

Ime	Tip	Obavezno
tenantId	string	Da
urlIdWS	string	Da
userIds	string	Da

Odgovor

Vraća: GetUserPresenceStatuses200Response

searchUsers

Parametri

Naziv	Tip	Obavezno
tenantId	string	Da
urlId	string	Da
usernameStartsWith	string	Da
mentionGroupIds	Array	Ne
sso	string	Ne

Odgovor

Vraća: SearchUsers200Response

getUser

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
id	string	Da

Odgovor

Vraća: GetUser200Response

Primjer

Primjer getUser

Copy

const tenantId: string = "acme-publishing-42";
const userIdOptional: string | undefined = "user_9d7b4c"; // može biti undefined u nekim tokovima (opcionalno)
const id: string = userIdOptional ?? "user_default_0001";
const result: GetUser200Response = await getUser(tenantId, id);
console.log(result);

createVote

Parametri

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

Odgovor

Vraća: VoteComment200Response

Primjer

createVote Primjer

Copy

(async () => {
  const tenantId: string = 'acme-tenant-812';
  const commentId: string = '5e8f8b7a-3d4b-4f1b-9a2e-1c9f2d6a7b8c';
  const direction: CreateVoteDirectionEnum = CreateVoteDirectionEnum.UP;
  const anonUserId: string = 'anon-84b9c2d';
  const voteResult: VoteComment200Response = await createVote(tenantId, commentId, direction, undefined, anonUserId);
  console.log(voteResult);
})();

deleteVote

Parametri

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

Odgovor

Vraća: DeleteCommentVote200Response

Primjer

Primjer deleteVote

Copy

const tenantId: string = 'tenant_7f3b21c9';
const id: string = 'vote_4a2d9f1b';
const editKey: string = 'edit_92b7c6a1';
const resultWithoutEditKey: DeleteCommentVote200Response = await deleteVote(tenantId, id);
const resultWithEditKey: DeleteCommentVote200Response = await deleteVote(tenantId, id, editKey);

getVotes

Parametri

Naziv	Tip	Obavezno	Opis
tenantId	string	Da
urlId	string	Da

Odgovor

Vraća: GetVotes200Response

Primjer

Primjer getVotes

Copy

const tenantId: string = 'tenant_9f8b3c_prod';
const urlId: string = '/news/2026/typescript-ecosystem-update';
const votes: GetVotes200Response = await getVotes(tenantId, urlId);
// Ako bi postojao opcionalni parametar, npr. includeHidden, mogao bi se koristiti ovako:
// const votesWithHidden: GetVotes200Response = await getVotes(tenantId, urlId, { includeHidden: true });

getVotesForUser

Parametri

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

Odgovor

Vraća: GetVotesForUser200Response

Primjer

Primjer getVotesForUser

Copy

const tenantId: string = 'tenant_acme_01';
const urlId: string = 'news/2026/01/12/product-launch';
const userId: string = 'user_9c3f2b';
const anonUserId: string = 'anon_d4e7a1';
const votesForUser: GetVotesForUser200Response = await getVotesForUser(tenantId, urlId, userId);
const votesForAnon: GetVotesForUser200Response = await getVotesForUser(tenantId, urlId, undefined, 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 rada

API referenca

Dokumentacija

Korištenje

Agregacija

Dnevnici revizije

Blokiranje komentara

Provjeri blokirane komentare

Komentari

Konfiguracije domena

Predlošci e-pošte

Dnevnik događaja

Objave feeda

Prijava komentara

Hashtagovi

Moderatori

Broj obavijesti

Obavijesti

Stranice

Webhook događaji na čekanju

Konfiguracije pitanja

Rezultati pitanja

Agregacija rezultata pitanja

SSO korisnici

Pretplate

Dnevna upotreba zakupnika

Paketi zakupnika

Korisnici zakupnika

Zakupnici

Učitaj sliku

Napredak značke korisnika

Značke korisnika

Obavijesti korisnika

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 (Single Sign-On)

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

aggregate

Parametri

Odgovor

getAuditLogs

Parametri

Odgovor

blockFromCommentPublic

Parametri

Odgovor

unBlockCommentPublic