API komentarzy na żywo

Użycie zasobów

Należy zauważyć, że pobieranie danych z API jest liczone jako użycie na Twoim koncie.

Każdy zasób wymieni, jakie jest to użycie, w swojej własnej sekcji.

Niektóre zasoby kosztują więcej w obsłudze niż inne. Każdy punkt końcowy ma ustalony koszt kredytów za wywołanie API. Dla niektórych punktów końcowych liczba kredytów zmienia się w zależności od opcji i rozmiarów odpowiedzi.

Użycie API można sprawdzić na stronie Billing Analytics i jest aktualizowane co kilka minut.

Uwaga!

Zalecamy najpierw przeczytać dokumentację Pages, aby ograniczyć zamieszanie przy określaniu, jakie wartości przekazać dla urlId w API komentarzy.

Webhooki

Subskrypcje webhooków mają własny przewodnik. POST, GET i DELETE /api/v1/webhooks, oraz GET /api/v1/webhooks/sample-payloads, są udokumentowane w sekcji Managing Subscriptions via API, a ładunki zdarzeń w Webhook Structures.

FastComments jest serwerem autoryzacji OAuth 2.1. Aplikacja może uzyskać token powiązany z jednym kontem FastComments i używać go na każdym punkcie końcowym w tym przewodniku zamiast klucza API. W ten sposób łączą się aplikacja Zapier, serwer MCP i inne integracje firm trzecich.

Tokeny są wydawane w przepływie kodu autoryzacji z PKCE. Nie ma grantu client credentials ani implicit.

Discovery

Lokalizacje punktów końcowych, obsługiwane granty i metody uwierzytelniania są publikowane pod standardowym adresem URL metadanych:

Metadane serwera autoryzacji

Copy

1

2https://fastcomments.com/.well-known/oauth-authorization-server

3

Punkty końcowe, które opisuje:

Punkty końcowe OAuth

Copy

1

2GET https://fastcomments.com/oauth/authorize

3POST https://fastcomments.com/oauth/token

4POST https://fastcomments.com/oauth/revoke

5POST https://fastcomments.com/oauth/register

6

Konta w regionie UE używają https://eu.fastcomments.com jako issuer, z tymi samymi ścieżkami.

Rejestracja klienta

Klient potrzebuje client_id i zarejestrowanego redirect_uri, zanim rozpocznie przepływ. Są dwa sposoby, aby je uzyskać:

• Dynamiczna rejestracja klienta. POST /oauth/register z treścią JSON zgodnie z RFC 7591 (redirect_uris, client_name, client_uri, logo_uri, token_endpoint_auth_method). Odpowiedź zawiera client_id, a dla klientów poufnych także client_secret. Rejestracja jest nieuwierzytelniona i ograniczona limitem na IP.
• Client ID Metadata Document. Klient używa kontrolowanego przez siebie adresu URL https jako swojego client_id. FastComments pobiera ten adres i odczytuje z niego te same pola metadanych. Wywołanie rejestracji nie jest potrzebne.

Aplikacje partnerskie wymienione w panelu FastComments, takie jak Zapier, są rejestrowane bezpośrednio przez FastComments. Skontaktuj się z pomocą techniczną, jeśli budujesz wpis w marketplace i potrzebujesz klienta pierwszej strony.

Zakresy (scopes)

Zakresy

Copy

1

2read żądania GET i HEAD

3write każda inna metoda

4

Żądanie bez określonego zakresu otrzymuje oba. Użytkownik widzi żądane zakresy na stronie zgody. Żądanie zakresu innego niż te dwa kończy się błędem invalid_scope.

Krok 1 - Żądanie autoryzacji

Przekieruj przeglądarkę użytkownika do punktu końcowego autoryzacji. PKCE z metodą S256 jest wymagane dla każdego klienta.

Żądanie autoryzacji

Copy

1

2GET https://fastcomments.com/oauth/authorize

3 ?response_type=code

4 &client_id=YOUR_CLIENT_ID

5 &redirect_uri=https://example.com/oauth/callback

6 &scope=read%20write

7 &state=RANDOM_STATE

8 &code_challenge=BASE64URL_SHA256_OF_VERIFIER

9 &code_challenge_method=S256

10

Parametry żądania autoryzacji

Copy

1

2interface OAuthAuthorizeQueryParams {

3 response_type: 'code'

4 client_id: string

5 /** Must exactly match one of the client's registered redirect URIs. **/

6 redirect_uri: string

7 /** Space separated. Omit to request both scopes. **/

8 scope?: 'read' | 'write' | 'read write'

9 /** Returned unchanged on the redirect. Use it to bind the callback to the session that started the flow. **/

10 state?: string

11 /** base64url(sha256(code_verifier)). **/

12 code_challenge: string

13 code_challenge_method: 'S256'

14 /** Optional RFC 8707 resource indicator. If sent, the same value must be sent to the token endpoint. **/

15 resource?: string

16}

17

Użytkownik loguje się do FastComments, jeśli to konieczne, i widzi stronę zgody z nazwą Twojej aplikacji, kontem, z którym zostanie połączona, oraz żądanymi zakresami. Użytkownik musi posiadać uprawnienie API Admin na tym koncie; każdy inny zobaczy błąd uprawnień zamiast formularza zgody. Zatwierdzenie przekierowuje przeglądarkę do Twojego redirect_uri z code i state. Odmowa przekierowuje z error=access_denied.

Kod autoryzacji jest ważny 10 minut i można go wymienić tylko raz. Druga wymiana tego samego kodu odwołuje wszystkie tokeny wyprodukowane przez pierwszą wymianę.

Krok 2 - Żądanie tokena

Wymień kod na tokeny. Treść jest zakodowana jako formularz. Klienci poufni uwierzytelniają się przez client_secret_basic (HTTP Basic) lub client_secret_post (sekret w treści). Klienci publiczni wysyłają tylko client_id.

Przykład cURL żądania tokena

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/oauth/token' \

4 --header 'Content-Type: application/x-www-form-urlencoded' \

5 --data 'grant_type=authorization_code' \

6 --data 'client_id=YOUR_CLIENT_ID' \

7 --data 'client_secret=YOUR_CLIENT_SECRET' \

8 --data 'code=fcac_...' \

9 --data 'code_verifier=YOUR_PKCE_VERIFIER' \

10 --data 'redirect_uri=https://example.com/oauth/callback'

11

Treść żądania tokena (authorization_code)

Copy

1

2interface OAuthTokenRequestAuthorizationCode {

3 grant_type: 'authorization_code'

4 client_id: string

5 /** Confidential clients only. May be sent as HTTP Basic auth instead. **/

6 client_secret?: string

7 code: string

8 code_verifier: string

9 /** Must match the authorization request when sent. **/

10 redirect_uri?: string

11 resource?: string

12}

13

Struktura odpowiedzi tokena

Copy

1

2interface OAuthTokenResponse {

3 /** Prefixed fcat_. Valid for one hour. **/

4 access_token: string

5 token_type: 'bearer'

6 /** Seconds until the access token expires. 3600. **/

7 expires_in: number

8 /** Prefixed fcrt_. Valid for 30 days from issue. **/

9 refresh_token: string

10 /** Space separated scopes granted. **/

11 scope: string

12}

13

Błędy zgodnie z RFC 6749: treść JSON z error i error_description, HTTP 400 dla invalid_request, invalid_grant, invalid_scope, invalid_target i unsupported_grant_type, HTTP 401 dla invalid_client, HTTP 429 przy ograniczeniu limitu.

Krok 3 - Wywoływanie API

Wysyłaj token dostępu jako bearer token. Najemca (tenant) jest implikowany przez token, więc tenantId jest opcjonalne. Jeśli podane, musi zgadzać się z tokenem, inaczej żądanie kończy się błędem.

Przykład cURL z bearer tokenem

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/me' \

4 --header 'Authorization: Bearer fcat_...'

5

GET /api/v1/me zwraca najemcę, autoryzującego użytkownika i przyznane zakresy, co czyni go właściwym wywołaniem do testu połączenia. Żądanie z wygasłym lub odwołanym tokenem otrzymuje HTTP 401. Żądanie, którego metoda wymaga zakresu, którego token nie posiada, otrzymuje HTTP 403.

Krok 4 - Odświeżanie

Przykład cURL żądania odświeżenia

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/oauth/token' \

4 --header 'Content-Type: application/x-www-form-urlencoded' \

5 --data 'grant_type=refresh_token' \

6 --data 'client_id=YOUR_CLIENT_ID' \

7 --data 'client_secret=YOUR_CLIENT_SECRET' \

8 --data 'refresh_token=fcrt_...'

9

Treść żądania tokena (refresh_token)

Copy

1

2interface OAuthTokenRequestRefreshToken {

3 grant_type: 'refresh_token'

4 client_id: string

5 client_secret?: string

6 refresh_token: string

7 /** Optional. Narrows to a subset of the scopes originally granted. **/

8 scope?: string

9 resource?: string

10}

11

Odpowiedź ma ten sam kształt co wymiana kodu. Refresh tokeny rotują: każde odświeżenie zwraca nowy refresh_token i odwołuje stary po 30-sekundowym oknie łaski dla żądań współbieżnych. Przedstawienie refresh tokena rotowanego ponad 30 sekund temu jest traktowane jako replay i odwołuje cały grant. Aplikacje partnerskie zarejestrowane przez FastComments są zwolnione z rotacji i otrzymują z powrotem ten sam refresh token z przedłużonym o kolejne 30 dni terminem ważności.

Odświeżenie ponownie sprawdza, czy autoryzujący użytkownik nadal posiada API Admin na koncie. Jeśli nie, grant jest odwoływany, a odpowiedź to invalid_grant.

Odwoływanie

Przykład cURL żądania odwołania

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/oauth/revoke' \

4 --header 'Content-Type: application/x-www-form-urlencoded' \

5 --data 'client_id=YOUR_CLIENT_ID' \

6 --data 'client_secret=YOUR_CLIENT_SECRET' \

7 --data 'token=fcrt_...' \

8 --data 'token_type_hint=refresh_token'

9

Odwołanie refresh tokena odwołuje wszystkie tokeny dostępu wydane z tego samego grantu. Odwołanie tokena dostępu odwołuje tylko ten token. Punkt końcowy zwraca HTTP 200 z pustym obiektem JSON niezależnie od tego, czy token został znaleziony, zgodnie z RFC 7009.

Użytkownicy mogą również odwołać połączenie z poziomu Connected Apps w panelu FastComments. Wszystkie tokeny tej aplikacji przestają działać natychmiast.

To API agreguje dokumenty, grupując je (jeśli zostanie podany parametr groupBy) i stosując wiele operacji. Obsługiwane są różne operacje (np. sum, countDistinct, avg, itp.).

Koszt jest zmienny. Za każde 500 przeskanowanych obiektów pobierany jest 1 kredyt API.

Maksymalne zużycie pamięci przy pojedynczym wywołaniu API domyślnie wynosi 64MB, a domyślnie można mieć uruchomioną tylko jedną agregację na raz. Jeśli wyślesz wiele agregacji jednocześnie, zostaną one umieszczone w kolejce i wykonywane w kolejności zgłoszeń. Agregacje oczekujące będą czekać maksymalnie 60 sekund, po tym czasie żądanie wygaśnie. Pojedyncze agregacje mogą działać do 5 minut.

Jeśli masz zarządzanych tenantów, możesz agregować zasoby wszystkich podrzędnych tenantów w jednym wywołaniu, przekazując parametr zapytania parentTenantId.

Przykłady

Przykład: Zliczanie unikalnych

Przykład cURL: zliczanie unikalnych wartości

Copy

1

2curl --request POST --url 'https://fastcomments.com/api/v1/aggregate?tenantId=demo&API_KEY=DEMO_API_SECRET&includeStats=true' --header 'Content-Type: application/json' --data '{

3 "resourceName": "Comment",

4 "operations": [

5 { "op": "distinct", "field": "urlId", "alias": "urlId" },

6 { "op": "distinct", "field": "commenterEmail", "alias": "commenterEmail" }

7 ]

8}'

9

Odpowiedź: zliczanie unikalnych wartości

Copy

1

2{

3 "status": "success",

4 "data": [

5 {

6 "commenterEmail": {

7 "distinctCounts": {

8 "someone@somewhere.com": 1,

9 "someone2@somewhere.com": 1

10 }

11 }

12 },

13 {

14 "urlId": {

15 "distinctCounts": {

16 "some-page": 2

17 }

18 }

19 }

20 ],

21 "stats": { "scanned": 2 }

22}

23

Przykład: Zliczanie różnych wartości

Przykład cURL: liczba różnych wartości

Copy

1

2curl --request POST --url 'https://fastcomments.com/api/v1/aggregate?tenantId=demo&API_KEY=DEMO_API_SECRET&includeStats=true' --header 'Content-Type: application/json' --data '{

3 "resourceName": "Comment",

4 "operations": [

5 { "op": "countDistinct", "field": "urlId", "alias": "urlId" },

6 { "op": "countDistinct", "field": "commenterEmail", "alias": "commenterEmail" }

7 ]

8}'

9

Odpowiedź:

Odpowiedź: liczba różnych wartości

Copy

1

2{

3 "status": "success",

4 "data": [

5 {

6 "commenterEmail": { "distinctCount": 2 },

7 "urlId": { "distinctCount": 1 }

8 }

9 ],

10 "stats": { "scanned": 2 }

11}

12

Przykład: Suma wartości wielu pól

Przykład cURL: suma wartości

Copy

1

2curl --request POST --url 'https://fastcomments.com/api/v1/aggregate?tenantId=demo&API_KEY=DEMO_API_SECRET&includeStats=true' --header 'Content-Type: application/json' --data '{

3 "resourceName": "Comment",

4 "operations": [

5 { "op": "sum", "field": "votes", "alias": "votes" },

6 { "op": "sum", "field": "votesUp", "alias": "votesUp" }

7 ]

8}'

9

Odpowiedź:

Odpowiedź: suma wartości

Copy

1

2{

3 "status": "success",

4 "data": [

5 {

6 "votes": { "numericValue": 2 },

7 "votesUp": { "numericValue": 2 }

8 }

9 ],

10 "stats": { "scanned": 2 }

11}

12

Przykład: Średnie wartości wielu pól

Przykład cURL: średnie wartości

Copy

1

2curl --request POST --url 'https://fastcomments.com/api/v1/aggregate?tenantId=demo&API_KEY=DEMO_API_SECRET&includeStats=true' --header 'Content-Type: application/json' --data '{

3 "resourceName": "Comment",

4 "operations": [

5 { "op": "avg", "field": "votes", "alias": "votes" },

6 { "op": "avg", "field": "votesUp", "alias": "votesUp" }

7 ]

8}'

9

Odpowiedź:

Odpowiedź: średnie wartości

Copy

1

2{

3 "status": "success",

4 "data": [

5 {

6 "votes": { "numericValue": 1 },

7 "votesUp": { "numericValue": 1 }

8 }

9 ],

10 "stats": { "scanned": 2 }

11}

12

Przykład: Wartości minimalne/maksymalne wielu pól

Przykład cURL: wartości min/max

Copy

1

2curl --request POST --url 'https://fastcomments.com/api/v1/aggregate?tenantId=demo&API_KEY=DEMO_API_SECRET&includeStats=true' --header 'Content-Type: application/json' --data '{

3 "resourceName": "Comment",

4 "operations": [

5 { "op": "min", "field": "votes", "alias": "votes" },

6 { "op": "min", "field": "votesUp", "alias": "votesUp" },

7 { "op": "max", "field": "votes", "alias": "votes" },

8 { "op": "max", "field": "votesUp", "alias": "votesUp" }

9 ]

10}'

11

Odpowiedź:

Odpowiedź: wartości min/max

Copy

1

2{

3 "status": "success",

4 "data": [

5 {

6 "votes": { "numericValue": 0 },

7 "votesUp": { "numericValue": 0 },

8 "votes": { "numericValue": 2 },

9 "votesUp": { "numericValue": 2 }

10 }

11 ],

12 "stats": { "scanned": 2 }

13}

14

Przykład: Zliczanie unikalnych wartości wielu pól

Przykład cURL: zliczanie unikalnych wartości

Copy

1

2curl --request POST --url 'https://fastcomments.com/api/v1/aggregate?tenantId=demo&API_KEY=DEMO_API_SECRET&includeStats=true' --header 'Content-Type: application/json' --data '{

3 "resourceName": "Comment",

4 "operations": [

5 { "op": "distinct", "field": "urlId", "alias": "urlId" },

6 { "op": "distinct", "field": "commenterEmail", "alias": "commenterEmail" }

7 ]

8}'

9

Odpowiedź:

Odpowiedź: zliczanie unikalnych wartości

Copy

1

2{

3 "status": "success",

4 "data": [

5 {

6 "commenterEmail": {

7 "distinctCounts": {

8 "someone@somewhere.com": 1,

9 "someone2@somewhere.com": 1

10 }

11 },

12 "urlId": {

13 "distinctCounts": {

14 "some-page": 2

15 }

16 }

17 }

18 ],

19 "stats": { "scanned": 2 }

20}

21

Przykład: Tworzenie zapytania

Przykład cURL: tworzenie zapytania

Copy

1

2curl --request POST --url 'https://fastcomments.com/api/v1/aggregate?tenantId=demo&API_KEY=DEMO_API_SECRET&includeStats=true' --header 'Content-Type: application/json' --data '{

3 "resourceName": "Comment",

4 "groupBy": ["commenterName"],

5 "query": [

6 { "key": "approved", "value": true, "operator": "eq" },

7 { "key": "commenterName", "value": "some-username-2", "operator": "eq" }

8 ],

9 "operations": [

10 { "op": "sum", "field": "votes", "alias": "votes" }

11 ]

12}'

13

Odpowiedź:

Odpowiedź: tworzenie zapytania

Copy

1

2{

3 "status": "success",

4 "data": [

5 {

6 "groups": { "commenterName": "some-username-2" },

7 "votes": { "numericValue": 2 }

8 }

9 ],

10 "stats": { "scanned": 1 }

11}

12

Przykład: Zliczanie komentarzy oczekujących na recenzję

Przykład cURL: zliczanie komentarzy oczekujących na recenzję

Copy

1

2curl --request POST --url 'https://fastcomments.com/api/v1/aggregate?tenantId=demo&API_KEY=DEMO_API_SECRET&includeStats=true' --header 'Content-Type: application/json' --data '{

3 "resourceName": "Comment",

4 "query": [

5 { "key": "reviewed", "value": true, "operator": "not_eq" }

6 ],

7 "operations": [

8 { "op": "count", "field": "id", "alias": "count" }

9 ]

10}'

11

Odpowiedź:

Odpowiedź: zliczanie komentarzy oczekujących na recenzję

Copy

1

2{

3 "status": "success",

4 "data": [

5 { "count": { "numericValue": 2 } }

6 ],

7 "stats": { "scanned": 2 }

8}

9

Przykład: Podział komentarzy na zatwierdzone, zrecenzowane i spam

Przykład cURL: rozkład komentarzy

Copy

1

2curl --request POST --url 'https://fastcomments.com/api/v1/aggregate?tenantId=demo&API_KEY=DEMO_API_SECRET&includeStats=true' --header 'Content-Type: application/json' --data '{

3 "resourceName": "Comment",

4 "operations": [

5 { "op": "distinct", "field": "approved", "alias": "approved" },

6 { "op": "distinct", "field": "reviewed", "alias": "reviewed" },

7 { "op": "distinct", "field": "isSpam", "alias": "isSpam" }

8 ]

9}'

10

Odpowiedź:

Odpowiedź: rozkład komentarzy

Copy

1

2{

3 "status": "success",

4 "data": [

5 {

6 "approved": { "distinctCounts": { "true": 2 } },

7 "reviewed": { "distinctCounts": { "false": 2 } },

8 "isSpam": { "distinctCounts": { "false": 2 } }

9 }

10 ],

11 "stats": { "scanned": 2 }

12}

13

Struktury

Struktura żądania agregacji

Copy

1

2export type AggregationOpType = 'sum' | 'countDistinct' | 'distinct' | 'avg' | 'min' | 'max' | 'count';

3

4/** Operacja, która zostanie zastosowana na polu */

5export interface AggregationOperation {

6 /** Pole, na którym wykona się operacja */

7 field: string;

8 /** Typ operacji */

9 op: AggregationOpType;

10 /** Opcjonalny alias dla wyniku; jeśli nie zostanie podany, zostanie obliczony domyślny alias */

11 alias?: string;

12 expandArray?: boolean;

13}

14

15export interface QueryPredicate {

16 key: string

17 value: string | number | boolean

18 operator: 'eq' | 'not_eq' | 'greater_than' | 'less_than' | 'contains'

19}

20

21export interface AggregationRequest {

22 query?: QueryPredicate[];

23 resourceName: string;

24 groupBy?: string[];

25 operations: AggregationOperation[];

26 sort?: {

27 field: string;

28 dir: 'asc' | 'desc';

29 };

30}

31

32type DistinctAccumulator = Record<string, number>;

33type GroupValues = Record<string, string>;

34

35export type AggregationValue = {

36 distinctCounts?: DistinctAccumulator

37 distinctCount?: number

38 numericValue?: number

39 stringValue?: string

40 groups?: GroupValues

41};

42

Struktura odpowiedzi agregacji

Copy

1

2export type AggregationItem = Record<string, AggregationValue> & { groups?: GroupValues };

3

4export interface AggregationResponse {

5 status: APIStatus,

6 data: AggregationItem[];

7 stats?: {

8 scanned: number;

9 timeMS: number;

10 };

11}

12

Następujące zasoby można agregować:

• AffiliateEvent
• AnonymousVote
• BannedUser
• BatchJob
• BlockedUser
• Comment
• CommentDeleted
• CommentIdToSyncOutbound
• CommentScheduled
• CommentSyncLog
• CustomConfig
• CustomEmailTemplateRenderError
• EmailToSend
• EventLogEntry
• ImportedCommentScheduled
• ModerationGroup
• Moderator
• Page
• PageReact
• PendingVote
• QuestionResult
• SSOUser
• SentEmail
• SpamEvent
• Tenant
• TenantAuditLog
• TenantBadge
• TenantDailyUsage
• TenantInvoiceHistory
• TenantPackage
• User
• UserBadge
• UserBadgeProgress
• UserNotification
• UserSubscription
• UserUsage
• Vote

To API używa paginacji, udostępnianej przez parametry skip, limit, before i after. AuditLogi są zwracane w stronach po 1000 domyślnie, do maksymalnego limit wynoszącego 10000, uporządkowane według when i id. Strony są duże, ponieważ ten endpoint jest zazwyczaj używany do zrzutu historii, a nie do interaktywnego przewijania.

Każde 100 zwróconych logów kosztuje 1 kredyt.

Domyślnie otrzymasz listę z najnowszymi elementami jako pierwsze. W ten sposób możesz pollować zaczynając od skip=0, paginując aż znajdziesz ostatni rekord, który już pobrałeś.

Alternatywnie możesz sortować od najstarszych, i paginować aż nie będzie już więcej rekordów.

Sortowanie można wykonać ustawiając order na ASC lub DESC. Domyślnie jest DESC.

Zapytania według daty są możliwe przy użyciu before i after jako znaczników czasu w milisekundach. before i after NIE są inkluzywne i każde z nich może być użyte samodzielnie.

Znalezienie, co stało się z osobą

Każde zdarzenie rejestruje, kto je wykonał (username, userId, ip) oraz, osobno, na czym zostało wykonane. targetLabel to czytelna etykieta tego obiektu, na przykład jsmith (jsmith@example.com), a targetId to jego identyfikator. Użyj target do dopasowania podciągu (bez uwzględniania wielkości liter) w etykiecie, gdy znasz imię lub e‑mail osoby, ale nie jej identyfikator.

Usunięcia przechwytują etykietę w momencie zdarzenia, więc usunięty użytkownik lub moderator może być nadal zidentyfikowany po usunięciu pierwotnego rekordu.

Zarządzane najemcy

Jeśli Twój tenant zarządza innymi tenantami, ustaw includeManagedTenants=true, aby zwrócić zdarzenia z Twojego tenantu oraz ze wszystkich tenantów, które on zarządza, w jednej odpowiedzi. tenantId każdego zwróconego logu informuje, z którego tenantu pochodzi.

Przykład cURL AuditLog

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/audit-logs?tenantId=demo&API_KEY=DEMO_API_SECRET&skip=0&order=ASC&before=123&after=456'

4

Struktura żądania AuditLog

Copy

1

2interface AuditLogsRequestQueryParams {

3 tenantId: string

4 API_KEY: string

5 order?: 'ASC' | 'DESC'

6 /** Maksymalnie 10000. Domyślnie 1000. **/

7 limit?: number

8 skip?: number

9 before?: number

10 after?: number

11 /** Tylko zdarzenia wykonane przez tę nazwę użytkownika. **/

12 username?: string

13 /** Tylko zdarzenia z tego adresu IP. **/

14 ip?: string

15 /** Tylko zdarzenia tego typu. **/

16 crudType?: 'c' | 'r' | 'u' | 'd' | 'login'

17 /** Tylko zdarzenia dla tego zasobu, np. Użytkownik lub Moderator. **/

18 resourceName?: string

19 /** Tylko zdarzenia, których dotknięty obiekt ma ten identyfikator. **/

20 targetId?: string

21 /** Dopasowanie podciągu (bez uwzględniania wielkości liter) w etykiecie dotkniętego obiektu. **/

22 target?: string

23 /** Również zwróć zdarzenia z tenantów, które ten tenant zarządza. **/

24 includeManagedTenants?: boolean

25}

26

Struktura odpowiedzi AuditLog

Copy

1

2interface AuditLogsResponse {

3 status: 'success' | 'failed'

4 /** Zawarte w przypadku niepowodzenia. **/

5 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'invalid-limit' | 'invalid-skip'

6 /** Zawarte w przypadku niepowodzenia. **/

7 reason?: string

8 /** Logi! **/

9 auditLogs: AuditLog[]

10}

11

Ta trasa zwraca zadania wsadowe (batch jobs) dzierżawy każdego typu, od najnowszych, 100 na stronę. Użyj type i status, aby zawęzić listę, oraz skip, aby ją stronicować.

Przykład cURL listy BatchJob

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/batch-jobs?tenantId=demo&API_KEY=DEMO_API_SECRET&type=migrate-pages&status=running'

4

Struktura żądania listy BatchJob

Copy

1

2interface BatchJobsQueryParams {

3 tenantId: string

4 API_KEY: string

5 /** Tylko zadania tego typu, na przykład migrate-pages. **/

6 type?: string

7 status?: 'requested' | 'running' | 'success' | 'failed'

8 /** Ile zadań pominąć, dla stronicowania. Nieujemna liczba całkowita. **/

9 skip?: number

10}

11

Struktura odpowiedzi listy BatchJob

Copy

1

2interface BatchJobsResponse {

3 status: 'success' | 'failed'

4 /** Dołączane w przypadku błędu. **/

5 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'invalid-skip' | 'internal'

6 /** Dołączane w przypadku błędu. **/

7 reason?: string

8 /** Od najnowszych, maksymalnie 100. **/

9 batchJobs?: BatchJob[]

10}

11

Ta trasa zwraca status, postęp i, po zakończeniu, wynik jednego zadania wsadowego. Użyj jej, aby śledzić zadanie rozpoczęte przez POST /api/v1/pages/migrations lub POST /api/v1/pages/migrations/:undoId/undo.

Zadanie jest zakończone, gdy jego status to success lub failed. Każde wywołanie kosztuje 1 kredyt, więc odpytywaj co kilka sekund zamiast ciągle.

Przykład cURL BatchJob według ID

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/batch-jobs/my-batch-job-id?tenantId=demo&API_KEY=DEMO_API_SECRET'

4

Struktura żądania BatchJob według ID

Copy

1

2interface BatchJobQueryParams {

3 tenantId: string

4 API_KEY: string

5}

6

Struktura odpowiedzi BatchJob według ID

Copy

1

2interface BatchJobResponse {

3 status: 'success' | 'failed'

4 /** Included on failure. **/

5 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'not-found' | 'internal'

6 /** Included on failure. **/

7 reason?: string

8 batchJob?: BatchJob

9}

10

Przykład zakończonego zadania migracji strony

Copy

1

2{

3 "status": "success",

4 "batchJob": {

5 "id": "my-batch-job-id",

6 "type": "migrate-pages",

7 "status": "success",

8 "createdAt": "2026-10-19T16:00:00.000Z",

9 "completedAt": "2026-10-19T16:00:12.000Z",

10 "processedCount": 2,

11 "totalCount": 2,

12 "pageMigrationResults": [

13 {"from": "old-post-id", "to": "new-post-id", "type": "urlId", "status": "success", "commentsMigrated": 42},

14 {"from": "old.example.com", "to": "new.example.com", "type": "domain", "status": "success", "commentsMigrated": 1250}

15 ],

16 "undoId": "my-undo-id"

17 }

18}

19

To API służy do pobierania komentarzy w celu wyświetlenia ich użytkownikowi. Na przykład automatycznie filtruje komentarze niezatwierdzone lub oznaczone jako spam.

Paginacja

Paginację można wykonać na jeden z dwóch sposobów, w zależności od wymagań wydajnościowych i przypadku użycia:

1. Najszybszy: Precalculated Pagination (prekalkulowana paginacja):
   1. Tak działa FastComments, gdy korzystasz z naszych gotowych widgetów i klientów.
   2. Kliknięcie „następna" po prostu zwiększa licznik stron.
   3. Można to sobie wyobrazić jako pobieranie z magazynu klucz-wartość.
   4. W ten sposób wystarczy zdefiniować parametr page zaczynający się od 0 oraz kierunek sortowania jako direction.
   5. Rozmiary stron można dostosować za pomocą reguł customizacji.
2. Najbardziej elastyczny: Flexible Pagination (elastyczna paginacja):
   1. W ten sposób można zdefiniować własne parametry limit i skip. Nie przekazuj page.
   2. Kierunek sortowania direction jest również obsługiwany.
   3. limit to całkowita liczba wyników do zwrócenia po zastosowaniu skip.
      • Przykład: ustaw skip = 200, limit = 100 przy page size = 100 i page = 2.
   4. Komentarze podrzędne nadal liczą się do paginacji. Można to obejść za pomocą opcji asTree.
      • Możesz paginować komentarze podrzędne za pomocą limitChildren i skipChildren.
      • Możesz ograniczyć głębokość zwracanych wątków za pomocą maxTreeDepth.

Wątki

1. Przy użyciu Precalculated Pagination komentarze są grupowane według strony, a komentarze w wątkach wpływają na całą stronę.
   1. W ten sposób wątki mogą być określane po stronie klienta na podstawie parentId.
   2. Na przykład, przy stronie z jednym komentarzem najwyższego poziomu i 29 odpowiedziami oraz ustawieniu page=0 w API - otrzymasz tylko komentarz najwyższego poziomu i 29 odpowiedzi.
2. Przy użyciu Flexible Pagination można zdefiniować parametr parentId.
   1. Ustaw go na null, aby pobierać tylko komentarze najwyższego poziomu.
   2. Następnie, aby wyświetlić wątki, wywołaj API ponownie i przekaż parentId.
   3. Częstym rozwiązaniem jest wykonanie wywołania API dla komentarzy najwyższego poziomu, a następnie równoległych wywołań API w celu pobrania komentarzy dla dzieci każdego komentarza.
3. NOWOŚĆ od lutego 2023! Pobieranie jako drzewo za pomocą &asTree=true.
   1. Można to sobie wyobrazić jako Flexible Pagination as a Tree.
   2. Tylko komentarze najwyższego poziomu liczą się do paginacji.
   3. Ustaw parentId=null, aby rozpocząć drzewo od korzenia (musisz ustawić parentId).
   4. Ustaw skip i limit dla paginacji.
   5. Ustaw asTree na true.
   6. Koszt w kredytach rośnie 2x, ponieważ nasz backend musi w tym scenariuszu wykonać znacznie więcej pracy.
   7. Ustaw maxTreeDepth, limitChildren i skipChildren według potrzeb.

Drzewa - wyjaśnienie

Przy użyciu asTree trudno jest rozumować o paginacji. Oto pomocny diagram:

Diagram paginacji drzewa

Pobieranie komentarzy w kontekście użytkownika

API /comments może być używane w dwóch kontekstach, dla różnych przypadków użycia:

• Do zwracania komentarzy posortowanych i oznaczonych informacjami, aby zbudować własnego klienta.
  • W tym przypadku zdefiniuj parametr zapytania contextUserId.
• Do pobierania komentarzy z Twojego backendu dla niestandardowych integracji.
  • Platforma domyślnie użyje tego trybu bez contextUserId.

Komentarze - Precalculated Pagination

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/comments?tenantId=demo&page=0&urlId=test&API_KEY=DEMO_API_SECRET&direction=MR'

4

Komentarze - Flexible Pagination

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/comments?tenantId=demo&urlId=test&API_KEY=DEMO_API_SECRET&direction=MR&skip=20&limit=10'

4

Komentarze - Flexible Pagination w kontekście użytkownika

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/comments?tenantId=demo&urlId=test&API_KEY=DEMO_API_SECRET&direction=MR&skip=20&limit=10&contextUserId=my-user-id'

4

Komentarze - Flexible Pagination w kontekście użytkownika, tylko komentarze najwyższego poziomu

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/comments?tenantId=demo&urlId=test&API_KEY=DEMO_API_SECRET&direction=MR&skip=20&limit=10&contextUserId=my-user-id&parentId=null'

4

Pobieranie komentarzy jako drzewa

Możliwe jest pobranie komentarzy jako drzewa, gdzie paginacja liczy tylko komentarze najwyższego poziomu.

Komentarze jako drzewo w kontekście użytkownika

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/comments?tenantId=demo&urlId=test&API_KEY=DEMO_API_SECRET&direction=MR&skip=20&limit=10&contextUserId=my-user-id&parentId=null&asTree=true'

4

Chcesz pobrać tylko komentarze najwyższego poziomu i ich bezpośrednie odpowiedzi? Oto jeden ze sposobów:

Komentarze jako drzewo z maksymalną głębokością

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/comments?tenantId=demo&urlId=test&API_KEY=DEMO_API_SECRET&direction=MR&skip=20&limit=10&contextUserId=my-user-id&parentId=null&asTree=true&maxTreeDepth=1&limitChildren=10'

4

Jednak w Twoim interfejsie użytkownika może być potrzebna informacja, czy wyświetlić przycisk „pokaż odpowiedzi" przy każdym komentarzu. Przy pobieraniu komentarzy jako drzewa istnieje właściwość hasChildren dodawana do komentarzy, gdy ma to zastosowanie.

Pobieranie komentarzy jako drzewa, wyszukiwanie po hashtagu

Możliwe jest wyszukiwanie po hashtagu za pomocą API, w obrębie całej Twojej tenanta (nie ograniczone do jednej strony ani urlId).

W tym przykładzie pomijamy urlId i wyszukujemy według wielu hashtagów. API zwróci tylko komentarze, które zawierają wszystkie żądane hashtagi.

Komentarze jako drzewo w kontekście użytkownika, według hashtagu

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/comments?tenantId=demo&API_KEY=DEMO_API_SECRET&direction=MR&skip=20&limit=10&contextUserId=my-user-id&parentId=null&asTree=true&hashTag=TestTag&hashTag=OtherTestTag'

4

Wszystkie parametry zapytania

Struktura zapytania Comments

Copy

1

2interface CommentsRequestQueryParams {

3 tenantId: string

4 API_KEY: string

5 /** The urlId (page url, or article id) the comments are associated with. **/

6 urlId?: string

7 /** Limit the comments returned by this user. **/

8 userId?: string

9 /** Use this to search by hashtag. To drill down to the intersection of multiple hashtags, do &hashTag=a&hashTag=b. **/

10 hashTag?: string

11 /** The sort direction. Default is MR (Most Relevant). Other options are OF (Oldest First) and NF (Newest First). **/

12 direction?: 'MR' | 'OF' | 'NF'

13 /** Precalculated Pagination: The page to fetch, starting with 0. Pass -1 for all comments (up to 250). **/

14 page?: number

15 /** Flexible Pagination: How many comments should we return? **/

16 limit?: number

17 /** Flexible Pagination: How many child comments should we return for each parent? **/

18 limitChildren?: number

19 /** Flexible Pagination: How many comments should we skip? **/

20 skip?: number

21 /** Flexible Pagination: How many child comments should we skip for each parent? **/

22 skipChildren?: number

23 /** For determining blocked and flagged comments. **/

24 contextUserId?: string

25 /** For determining blocked and flagged comments. **/

26 anonUserId?: string

27 /** For fetching child comments. **/

28 parentId?: string

29 /** For fetching as a tree. **/

30 asTree?: boolean

31 /** How far into the tree should we return data? 0 returns no children. 1 returns immediate children, etc. **/

32 maxTreeDepth?: number

33}

34

Odpowiedź

Struktura odpowiedzi Comments

Copy

1

2interface CommentsResponse {

3 status: 'success' | 'failed'

4 /** Included on failure. **/

5 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'missing-url-id' | 'missing-date' | 'unauthorized-page' | 'invalid-pagination-request' | 'invalid-limit' | 'invalid-limit-children' | 'invalid-skip' | 'invalid-skip-children' | 'invalid-max-tree-depth'

6 /** Included on failure. **/

7 reason?: string

8 /** The comments! **/

9 comments: Comment[]

10}

11

Przydatne wskazówki

URL ID

Prawdopodobnie chcesz używać API Comment z parametrem urlId. Możesz najpierw wywołać API Pages, aby zobaczyć, jak wyglądają dostępne dla Ciebie wartości urlId.

Akcje anonimowe

Dla anonimowego komentowania prawdopodobnie chcesz przekazywać anonUserId przy pobieraniu komentarzy oraz przy zgłaszaniu i blokowaniu.

(!) Jest to wymagane przez wiele sklepów z aplikacjami, ponieważ użytkownicy muszą mieć możliwość zgłaszania treści tworzonych przez użytkowników, które widzą, nawet jeśli nie są zalogowani. Niezastosowanie się może spowodować usunięcie Twojej aplikacji z danego sklepu.

Komentarze nie są zwracane

Sprawdź, czy Twoje komentarze są zatwierdzone i nie są oznaczone jako spam.

To API umożliwia pobranie pojedynczego komentarza po identyfikatorze.

Przykład cURL pobierania komentarza po ID

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/comments/some-id?tenantId=demo&API_KEY=DEMO_API_SECRET'

4

Struktura żądania pobierania komentarza po ID

Copy

1

2interface CommentsGetByIdQueryParams {

3 tenantId: string

4 API_KEY: string

5}

6

Struktura odpowiedzi pobierania komentarza po ID

Copy

1

2interface CommentGetByIdResponse {

3 status: 'success' | 'failed'

4 /** Dołączane w przypadku niepowodzenia. **/

5 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'not-found' | 'missing-id'

6 /** Dołączane w przypadku niepowodzenia. **/

7 reason?: string

8 /** Komentarz! **/

9 comment?: Comment

10}

11

Ten endpoint API umożliwia tworzenie komentarzy.

Typowe przypadki użycia to niestandardowe interfejsy użytkownika, integracje lub importy.

Uwagi:

• Ten interfejs API może zaktualizować widżet komentarzy "na żywo", jeśli jest taka potrzeba (zwiększa to creditsCost z 1 do 2).
• Ten interfejs API automatycznie utworzy obiekty użytkowników w naszym systemie, jeśli podany zostanie adres e-mail.
• Próba zapisania dwóch komentarzy z różnymi adresami e-mail, ale taką samą nazwą użytkownika, spowoduje błąd dla drugiego komentarza.
• Jeśli określasz parentId, a komentarz potomny ma notificationSentForParent ustawione na false, wyślemy powiadomienia dla komentarza nadrzędnego. Odbywa się to co godzinę (grupujemy powiadomienia, aby zmniejszyć liczbę wysyłanych e-maili).
• Jeśli chcesz wysyłać e-maile powitalne podczas tworzenia użytkowników lub e-maile weryfikacyjne komentarzy, ustaw sendEmails na true w parametrach zapytania.
• Komentarze utworzone za pomocą tego interfejsu API będą widoczne na stronach Analityka i Moderacja w aplikacji administracyjnej.
• „wulgaryzmy” nadal są maskowane w nazwach komentujących i tekście komentarza, jeśli ustawienie jest włączone.
• Komentarze utworzone przez ten interfejs API nadal mogą być sprawdzane pod kątem spamu, jeśli zajdzie taka potrzeba.
• Konfiguracje, takie jak maksymalna długość komentarza, jeśli są skonfigurowane za pomocą strony administracyjnej Customization Rule, będą miały tu zastosowanie.

Minimalne dane wymagane do przesłania, które będą wyświetlane w widżecie komentarzy, są następujące:

Minimalny przykład POST komentarza cURL

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/api/v1/comments?tenantId=demo&API_KEY=DEMO_API_SECRET&isLive=true' \

4 --header 'Content-Type: application/json' \

5 --data '{

6 "approved": true,

7 "comment": "some-comment",

8 "commenterName": "some-commenter-name",

9 "date": 1622644382148,

10 "urlId": "some-place",

11 "url": "https://exmaple.com/some-page",

12 "verified": true

13}'

14

Bardziej realistyczne żądanie może wyglądać następująco:

Przykład POST komentarza cURL

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/api/v1/comments?tenantId=demo&API_KEY=DEMO_API_SECRET&isLive=true&doSpamCheck=true' \

4 --header 'Content-Type: application/json' \

5 --data '{

6 "approved": true,

7 "avatarSrc": "https://static.fastcomments.com/1605337537848-DSC_0841.JPG",

8 "comment": "some-comment",

9 "commenterName": "some-commenter-name",

10 "commenterEmail": "fordperfect@spaceship.com",

11 "date": 1622644382148,

12 "isSpam": false,

13 "locale": "en_us",

14 "notificationSentForParent": true,

15 "notificationSentForParentTenant": true,

16 "reviewed": true,

17 "urlId": "some-place",

18 "url": "https://exmaple.com/some-page",

19 "verified": true,

20 "votes": 1,

21 "votesUp": 2,

22 "votesDown": 1,

23 "ip": "123.456.789.000"

24}'

25

Struktura żądania POST komentarza

Copy

1

2interface CommentPostQueryParams {

3 tenantId: string

4 API_KEY: string

5 doSpamCheck?: 'true' | 'false'

6 /** Czy komentarz powinien pojawić się "na żywo" dla użytkowników przeglądających instancje widżetu komentarzy o tym samym urlId. Uwaga: Podwaja koszt kredytów z 1 do 2. **/

7 isLive?: 'true' | 'false'

8 sendEmails?: 'true' | 'false'

9 populateNotifications?: 'true' | 'false'

10}

11

Struktura odpowiedzi POST komentarza

Copy

1

2

3interface CommentPostResponse {

4 status: 'success' | 'failed'

5 /** Zawarte w przypadku niepowodzenia. **/

6 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'missing-url-id' | 'empty-comment' | 'comment-too-big' | 'hash-tags-readonly' | 'mentions-readonly' | 'invalid-user' | 'unauthorized' | 'invalid-date' | 'invalid-name' | 'invalid-name-is-email' | 'banned' | 'invalid-email';

7 /** Zawarte w przypadku niepowodzenia. **/

8 reason?: string

9 /** Utworzony komentarz. **/

10 comment?: Comment

11 /** Powiązany użytkownik, który mógł już istnieć lub nie. **/

12 user?: User

13}

14

Ten endpoint API umożliwia aktualizację pojedynczego komentarza.

Notes:

• Ta metoda API może zaktualizować widżet komentarzy "na żywo", jeśli chcesz (to zwiększa podstawowy creditsCost z 1 do 2).
  • To pozwala na przeprowadzanie migracji komentarzy między stronami "na żywo" (zmiana urlId).
  • Migracje kosztują dodatkowe 2 kredyty, ponieważ strony są przeliczane wstępnie i jest to intensywne obliczeniowo.
• W przeciwieństwie do API tworzenia, to API NIE będzie automatycznie tworzyć obiektów użytkowników w naszym systemie, jeśli podany zostanie e-mail.
• Komentarze zaktualizowane przez to API nadal mogą być sprawdzane pod kątem spamu, jeśli chcesz.
• Konfiguracje takie jak maksymalna długość komentarza, jeśli są skonfigurowane na stronie administracyjnej Customization Rule, będą miały zastosowanie tutaj.
• Aby pozwolić użytkownikom na aktualizację tekstu komentarza, możesz po prostu określić comment w ciele żądania. Wygenerujemy wynikowy commentHTML.
  • Jeśli zdefiniujesz zarówno comment, jak i commentHTML, nie wygenerujemy automatycznie HTML.
  • Jeśli użytkownik doda wzmianki lub hashtagi w nowym tekście, będą one przetwarzane jak w API POST.
• Podczas aktualizacji commenterEmail w komentarzu najlepiej jest również podać userId. W przeciwnym razie musisz upewnić się, że użytkownik z tym adresem e-mail należy do Twojego tenanta, w przeciwnym razie żądanie zakończy się niepowodzeniem.
• Jeśli docelowy komentarz jest zablokowany (isLocked: true), żądanie zostanie odrzucone z code: 'locked'. Najpierw odblokuj komentarz, zaktualizuj go, a następnie ponownie zablokuj, jeśli chcesz.

Minimalny przykład żądania cURL PATCH komentarza

Copy

1

2curl --request PATCH \

3 --url 'https://fastcomments.com/api/v1/comments/some-comment-id?tenantId=demo&API_KEY=DEMO_API_SECRET&isLive=true' \

4 --header 'Content-Type: application/json' \

5 --data '{

6 "comment": "some-new-comment-text"

7}'

8

Struktura żądania PATCH komentarza

Copy

1

2interface CommentPatchQueryParams {

3 tenantId: string

4 API_KEY: string

5 /** Użytkownik wykonujący aktualizację. W razie potrzeby można go użyć do sprawdzenia, czy może edytować komentarz. **/

6 contextUserId?: string

7 /** Czy powinniśmy sprawdzić, czy nowy komentarz wygląda na spam? **/

8 doSpamCheck?: 'true' | 'false'

9 /** Czy komentarz powinien być widoczny "na żywo" dla użytkowników przeglądających wystąpienia widżetu komentarzy z tym samym urlId. UWAGA: Podwaja koszt kredytów z 1 do 2. **/

10 isLive?: 'true' | 'false'

11}

12

Struktura odpowiedzi PATCH komentarza

Copy

1

2

3interface CommentPatchResponse {

4 status: 'success' | 'failed'

5 /** Dołączone w przypadku niepowodzenia. **/

6 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'missing-url-id' | 'empty-comment' | 'comment-too-big' | 'hash-tags-readonly' | 'mentions-readonly' | 'invalid-user' | 'unauthorized' | 'invalid-date' | 'invalid-name' | 'invalid-name-is-email' | 'banned' | 'invalid-email' | 'invalid-input' | 'missing-id' | 'not-found' | 'locked'

7 /** Dołączone w przypadku niepowodzenia. **/

8 reason?: string

9}

10

Ten endpoint API umożliwia usunięcie komentarza.

Uwagi:

• To API może zaktualizować widżet komentarzy "na żywo", jeśli zajdzie taka potrzeba (zwiększa to creditsCost z 1 do 2).
• To API usunie wszystkie komentarze podrzędne.
• Jeśli docelowy komentarz jest zablokowany (isLocked: true), żądanie zostaje odrzucone z code: 'locked'. Najpierw odblokuj komentarz, a następnie usuń.

Przykład cURL usuwania komentarza

Copy

1

2curl --request DELETE \

3 --url 'https://fastcomments.com/api/v1/comments/some-comment-id?tenantId=demo&API_KEY=DEMO_API_SECRET' \

4 --header 'Content-Type: application/json'

5

Struktura żądania DELETE komentarza

Copy

1

2interface CommentDeleteQueryParams {

3 tenantId: string

4 API_KEY: string

5 /** Użytkownik wykonujący aktualizację. W razie potrzeby może być użyty do sprawdzenia, czy może usunąć komentarz. **/

6 contextUserId?: string

7 /** Czy komentarz powinien zostać usunięty "na żywo" dla użytkowników przeglądających instancje widżetu komentarzy z tym samym urlId. UWAGA: Podwaja koszt kredytów z 1 do 2. **/

8 isLive?: 'true' | 'false'

9}

10

Struktura odpowiedzi DELETE komentarza

Copy

1

2

3interface CommentDeleteResponse {

4 status: 'success' | 'failed'

5 /** Dołączone w przypadku niepowodzenia. **/

6 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'missing-id' | 'not-found' | 'locked'

7 /** Dołączone w przypadku niepowodzenia. **/

8 reason?: string

9}

10

Ten punkt końcowy API umożliwia zgłoszenie (oflagowanie) komentarza dla konkretnego użytkownika.

Uwagi:

• To wywołanie zawsze musi być wykonane w kontekście użytkownika. Użytkownikiem może być użytkownik FastComments.com, użytkownik SSO lub użytkownik dzierżawy (Tenant User).
• Jeśli ustawiony jest próg flag-do-ukrycia, komentarz zostanie automatycznie ukryty na żywo po zgłoszeniu go zdefiniowaną liczbę razy.
• Po automatycznym cofnięciu zatwierdzenia (ukryciu) - komentarz może zostać ponownie zatwierdzony tylko przez administratora lub moderatora. Usunięcie flagi nie spowoduje ponownego zatwierdzenia komentarza.

Przykład cURL zgłoszenia komentarza

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/api/v1/comments/some-comment-id/flag?tenantId=demo&API_KEY=DEMO_API_SECRET&userId=some-user-id' \

4 --header 'Content-Type: application/json'

5

W przypadku zgłoszeń anonimowych musimy podać anonUserId. Może to być identyfikator reprezentujący sesję anonimową lub losowy UUID. Pozwala to na obsługę zgłaszania i cofania zgłoszeń komentarzy nawet wtedy, gdy użytkownik nie jest zalogowany. Dzięki temu komentarz może zostać oznaczony jako zgłoszony, gdy komentarze są pobierane z tym samym anonUserId.

Przykład cURL anonimowego zgłoszenia komentarza

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/api/v1/comments/some-comment-id/flag?tenantId=demo&API_KEY=DEMO_API_SECRET&anonUserId=some-anon-user-id' \

4 --header 'Content-Type: application/json'

5

Struktura żądania zgłoszenia komentarza

Copy

1

2interface CommentFlagQueryParams {

3 tenantId: string

4 API_KEY: string

5 userId?: string

6 anonUserId?: string

7}

8

Struktura odpowiedzi zgłoszenia komentarza

Copy

1

2

3interface CommentFlagResponse {

4 status: 'success' | 'failed'

5 /** Included on failure. **/

6 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'missing-id' | 'not-found' | 'missing-user-id' | 'missing-anon-user-id'

7 /** Included on failure. **/

8 reason?: string

9 /** Was the comment un-approved (hidden) due to being flagged too many times? **/

10 wasUnapproved?: boolean;

11}

12

Ten endpoint API umożliwia usunięcie flagi z komentarza dla konkretnego użytkownika.

Notes:

• To wywołanie musi być zawsze wykonane w kontekście użytkownika. The user can be a FastComments.com User, SSO User, or Tenant User.
• Po tym, jak komentarz zostanie automatycznie odrzucony (ukryty) - komentarz może zostać ponownie zatwierdzony tylko przez administratora lub moderatora. Usunięcie flagi nie spowoduje ponownego zatwierdzenia komentarza.

Przykład cURL: cofnięcie flagi komentarza

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/api/v1/comments/some-comment-id/un-flag?tenantId=demo&API_KEY=DEMO_API_SECRET&userId=some-user-id' \

4 --header 'Content-Type: application/json'

5

W przypadku anonimowego zgłaszania musimy określić anonUserId. Może to być identyfikator reprezentujący sesję anonimową lub losowy UUID.

Przykład cURL: cofnięcie flagi anonimowego komentarza

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/api/v1/comments/some-comment-id/un-flag?tenantId=demo&API_KEY=DEMO_API_SECRET&anonUserId=some-anon-user-id' \

4 --header 'Content-Type: application/json'

5

Struktura żądania cofnięcia flagi komentarza

Copy

1

2interface CommentFlagQueryParams {

3 tenantId: string

4 API_KEY: string

5 userId?: string

6 anonUserId?: string

7}

8

Struktura odpowiedzi cofnięcia flagi komentarza

Copy

1

2

3interface CommentUnFlagResponse {

4 status: 'success' | 'failed'

5 /** Dołączone w przypadku niepowodzenia. **/

6 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'missing-id' | 'not-found' | 'missing-user-id' | 'missing-anon-user-id'

7 /** Dołączone w przypadku niepowodzenia. **/

8 reason?: string

9}

10

Ten punkt końcowy API umożliwia zablokowanie użytkownika, który napisał dany komentarz. Obsługuje blokowanie komentarzy napisanych przez użytkowników FastComments.com, użytkowników SSO oraz użytkowników Tenant.

Obsługuje parametr body commentIdsToCheck, aby sprawdzić, czy inne potencjalnie widoczne komentarze po stronie klienta powinny zostać zablokowane/odblokowane po wykonaniu tej akcji.

Uwagi:

• To wywołanie zawsze musi być wykonane w kontekście użytkownika. Użytkownikiem może być użytkownik FastComments.com, użytkownik SSO lub użytkownik Tenant.
• userId w żądaniu to użytkownik, który dokonuje blokowania. Na przykład: User A chce zablokować User B. Przekaż userId=User A oraz identyfikator komentarza napisanego przez User B.
• Całkowicie anonimowe komentarze (bez identyfikatora użytkownika, bez adresu e-mail) nie mogą być blokowane — zostanie zwrócony błąd.

Przykład cURL blokowania komentarza

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/api/v1/comments/some-comment-id/block?tenantId=demo&API_KEY=DEMO_API_SECRET&userId=some-user-id' \

4 --header 'Content-Type: application/json'

5

W przypadku blokowania anonimowego musimy określić anonUserId. Może to być identyfikator reprezentujący sesję anonimową lub losowy UUID. Pozwala to na obsługę blokowania komentarzy nawet wtedy, gdy użytkownik nie jest zalogowany, poprzez pobranie komentarzy z tym samym anonUserId.

Przykład cURL anonimowego blokowania komentarza

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/api/v1/comments/some-comment-id/block?tenantId=demo&API_KEY=DEMO_API_SECRET&anonUserId=some-anon-user-id' \

4 --header 'Content-Type: application/json'

5

Struktura żądania blokowania komentarza

Copy

1

2interface CommentBlockQueryParams {

3 tenantId: string

4 API_KEY: string

5 userId?: string

6 anonUserId?: string

7 commentIdsToCheck?: string[]

8}

9

Struktura odpowiedzi blokowania komentarza

Copy

1

2

3interface CommentBlockResponse {

4 status: 'success' | 'failed'

5 /** Included on failure. **/

6 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'missing-id' | 'not-found' | 'missing-user-id' | 'missing-anon-user-id' | 'comment-cannot-be-blocked'

7 /** Included on failure. **/

8 reason?: string

9 /** If commentIdsToCheck is defined, entries in this map with true are also blocked. **/

10 commentStatuses?: Record<string, boolean>;

11}

12

Ten punkt końcowy API umożliwia odblokowanie użytkownika, który napisał dany komentarz. Obsługuje odblokowywanie komentarzy napisanych przez użytkowników FastComments.com, użytkowników SSO oraz użytkowników najemcy.

Obsługuje parametr w body commentIdsToCheck, aby sprawdzić, czy po wykonaniu tej akcji inne potencjalnie widoczne komentarze po stronie klienta powinny zostać zablokowane/odblokowane.

Uwagi:

• To wywołanie musi być zawsze wykonane w kontekście użytkownika. Użytkownik może być użytkownikiem FastComments.com, użytkownikiem SSO lub użytkownikiem najemcy.
• Pole userId w żądaniu to użytkownik, który wykonuje odblokowanie. Na przykład: User A chce odblokować User B. Przekaż userId=User A oraz identyfikator komentarza, który napisał User B.
• Całkowicie anonimowe komentarze (bez id użytkownika, bez adresu e-mail) nie mogą być zablokowane i zostanie zwrócony błąd.

Przykład cURL — odblokowanie komentarza

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/api/v1/comments/some-comment-id/un-block?tenantId=demo&API_KEY=DEMO_API_SECRET&userId=some-user-id' \

4 --header 'Content-Type: application/json'

5

Przykład cURL — odblokowanie anonimowego komentarza

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/api/v1/comments/some-comment-id/un-block?tenantId=demo&API_KEY=DEMO_API_SECRET&anonUserId=some-anon-user-id' \

4 --header 'Content-Type: application/json'

5

Struktura żądania odblokowania komentarza

Copy

1

2interface CommentUnBlockQueryParams {

3 tenantId: string

4 API_KEY: string

5 userId?: string

6 anonUserId?: string

7 commentIdsToCheck?: string[]

8}

9

Struktura odpowiedzi odblokowania komentarza

Copy

1

2

3interface CommentUnBlockResponse {

4 status: 'success' | 'failed'

5 /** Dołączone w przypadku niepowodzenia. **/

6 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'missing-id' | 'not-found' | 'missing-user-id' | 'missing-anon-user-id' | 'comment-cannot-be-blocked'

7 /** Dołączone w przypadku niepowodzenia. **/

8 reason?: string

9 /** Jeśli commentIdsToCheck jest zdefiniowane, wpisy w tej mapie z wartością true są nadal zablokowane. Jeśli false, możesz chcieć przywrócić widoczność komentarzy dla użytkownika, aby nie musiał odświeżać strony. **/

10 commentStatuses?: Record<string, boolean>;

11}

12

Poszczególne obiekty EmailTemplate można pobrać za pomocą odpowiadającego im id (NIE emailTemplateId).

Przykład cURL dla EmailTemplate według ID

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/email-templates/xyz?tenantId=demo&API_KEY=DEMO_API_SECRET'

4

Struktura żądania EmailTemplate według ID

Copy

1

2interface EmailTemplatesByIdRequestQueryParams {

3 tenantId: string

4 API_KEY: string

5}

6

Struktura odpowiedzi EmailTemplate według ID

Copy

1

2interface EmailTemplateResponse {

3 status: 'success' | 'failed'

4 /** Dołączone w przypadku niepowodzenia. **/

5 code?: 'internal' | 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'not-found'

6 /** Dołączone w przypadku niepowodzenia. **/

7 reason?: string

8 emailTemplate?: EmailTemplate | null

9}

10

To API używa paginacji, dostarczanej przez parametr zapytania page. EmailTemplates są zwracane w stronach po 100, posortowane według createdAt, a następnie id.

Przykład żądania cURL EmailTemplate

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/email-templates?tenantId=demo&page=0&API_KEY=DEMO_API_SECRET'

4

Struktura żądania EmailTemplate

Copy

1

2interface EmailTemplatesRequestQueryParams {

3 tenantId: string

4 API_KEY: string

5 /** Strona do pobrania, zaczynając od 0. **/

6 page: number

7}

8

Struktura odpowiedzi EmailTemplate

Copy

1

2interface EmailTemplatesResponse {

3 status: 'success' | 'failed'

4 /** Dołączone w przypadku niepowodzenia. **/

5 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key'

6 /** Dołączone w przypadku niepowodzenia. **/

7 reason?: string

8 emailTemplates: EmailTemplate[]

9}

10

Ten punkt końcowy API umożliwia aktualizację szablonu e-mail poprzez podanie jedynie id oraz atrybutów do zaktualizowania.

Zauważ, że wszystkie te same walidacje, które obowiązują przy tworzeniu szablonu, mają zastosowanie również tutaj, na przykład:

• Szablon musi się renderować. Jest to sprawdzane przy każdej aktualizacji.
• Nie można mieć zduplikowanych szablonów dla tej samej domeny (w przeciwnym razie jeden zostałby zignorowany bez komunikatu).

Przykład cURL dla EmailTemplate PATCH

Copy

1

2curl --request PATCH \

3 --url 'https://fastcomments.com/api/v1/email-templates/xyz?tenantId=demo&API_KEY=DEMO_API_SECRET' \

4 --header 'Content-Type: application/json' \

5 --data '{

6 "displayName": "Some New Name",

7}'

8

Struktura żądania PATCH EmailTemplate

Copy

1

2interface EmailTemplatePatchQueryParams {

3 tenantId: string

4 API_KEY: string

5}

6

Struktura odpowiedzi PATCH EmailTemplate

Copy

1

2

3interface EmailTemplatePatchResponse {

4 status: 'success' | 'failed'

5 /** Dołączone w przypadku niepowodzenia. **/

6 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'empty-request' | 'internal' | 'invalid-input' | 'not-found' | 'unexpected-param' | 'invalid-email-template-id' | 'unauthorized' | 'domain-invalid' | 'duplicate' | 'does-not-render';

7 /** Dołączone w przypadku niepowodzenia. **/

8 reason?: string

9 /** Zaktualizowany szablon e-mail. **/

10 emailTemplate?: EmailTemplate

11}

12

Ten punkt końcowy API umożliwia tworzenie szablonów e-mail.

Uwagi:

• Nie możesz mieć wielu szablonów z tym samym emailTemplateId dla tej samej domeny.
• Ale możesz mieć szablon wieloznaczny (domain = * oraz szablon specyficzny dla domeny dla tego samego emailTemplateId).
• Określanie domain ma znaczenie tylko wtedy, gdy masz różne domeny lub chcesz używać specyficznych szablonów do testów (domain ustawione na localhost itd.).
• Jeśli określisz domain, musi ono pasować do DomainConfig. W przypadku błędu zwracana jest lista prawidłowych domen.
• Składnia szablonu to EJS i jest renderowana z limitem czasu 500 ms. P99 dla renderowania wynosi <5 ms, więc jeśli osiągniesz 500 ms, coś jest nie tak.
• Twój szablon musi się wyrenderować z podanym testData, aby mógł zostać zapisany. Błędy renderowania są agregowane i raportowane w panelu (wkrótce dostępne przez API).

Minimalne dane wymagane do dodania szablonu są następujące:

Minimalny przykład cURL POST EmailTemplate

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/api/v1/email-templates?tenantId=demo&API_KEY=DEMO_API_SECRET' \

4 --header 'Content-Type: application/json' \

5 --data '{

6 "emailTemplateId": "comment-user-mention",

7 "displayName": "I'm a custom template.",

8 "ejs": "This is an @mention notification! My name is <%= comment.commenterName %>."

9}'

10

Możesz chcieć mieć szablony per strona — w takim przypadku definiujesz domain:

Przykład cURL POST EmailTemplate

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/api/v1/email-templates?tenantId=demo&API_KEY=DEMO_API_SECRET' \

4 --header 'Content-Type: application/json' \

5 --data '{

6 "emailTemplateId": "comment-user-mention",

7 "displayName": "I'm a custom template.",

8 "ejs": "This is some email content!",

9 "domain": "somespecificsite.com",

10}'

11

Struktura żądania POST EmailTemplate

Copy

1

2interface EmailTemplatePostQueryParams {

3 tenantId: string

4 API_KEY: string

5}

6

Struktura odpowiedzi POST EmailTemplate

Copy

1

2

3interface EmailTemplatePostResponse {

4 status: 'success' | 'failed'

5 /** Included on failure. **/

6 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'unauthorized' | 'unexpected-param' | 'invalid-email-template-id' | 'domain-invalid' | 'duplicate' | 'does-not-render';

7 /** Included on failure. **/

8 reason?: string

9 /** The created template. **/

10 emailTemplate?: EmailTemplate

11}

12

Ten punkt końcowy API umożliwia podgląd szablonów e-mail.

Minimalny przykład żądania cURL POST podglądu EmailTemplate

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/api/v1/email-templates/render?tenantId=demo&API_KEY=DEMO_API_SECRET' \

4 --header 'Content-Type: application/json' \

5 --data '{

6 "emailTemplateId": "comment-user-mention",

7 "displayName": "I'm a custom template.",

8 "ejs": "This is an @mention notification! My name is <%= comment.commenterName %>."

9}'

10

Struktura żądania POST EmailTemplate

Copy

1

2interface EmailTemplatePostQueryParams {

3 tenantId: string

4 API_KEY: string

5}

6

Struktura odpowiedzi POST EmailTemplate

Copy

1

2

3interface EmailTemplatePostResponse {

4 status: 'success' | 'failed'

5 /** Dołączone w przypadku niepowodzenia. **/

6 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'unauthorized' | 'unexpected-param' | 'does-not-render';

7 /** Dołączone w przypadku niepowodzenia. **/

8 reason?: string

9 /** Wyrenderowany HTML w przypadku powodzenia. **/

10 html?: string

11}

12

Ta trasa umożliwia usunięcie pojedynczego EmailTemplate według identyfikatora.

Przykład żądania cURL usunięcia EmailTemplate

Copy

1

2curl --request DELETE \

3 --url 'https://fastcomments.com/api/v1/email-templates/xyz?tenantId=demo&API_KEY=DEMO_API_SECRET'

4

Struktura żądania usunięcia EmailTemplate

Copy

1

2interface EmailTemplateRequestQueryParams {

3 tenantId: string

4 API_KEY: string

5}

6

Struktura odpowiedzi usunięcia EmailTemplate

Copy

1

2interface EmailTemplateDeleteResponse {

3 status: 'success' | 'failed'

4 /** Dołączone w przypadku niepowodzenia. **/

5 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'not-found' | 'unauthorized'

6 /** Dołączone w przypadku niepowodzenia. **/

7 reason?: string

8}

9

Pobiera posty w kanale, najnowsze jako pierwsze. Paginacja oparta jest na kursorze: przekaż _id ostatniego otrzymanego posta jako afterId, aby uzyskać następną stronę.

Kosztuje jeden kredyt za dziesięć zwróconych postów, z minimum jednym kredytem.

Przykład cURL FeedPost

Copy

1

2curl --request GET \

3 --url 'https://fastcomments.com/api/v1/feed-posts?tenantId=demo&limit=10&API_KEY=DEMO_API_SECRET'

4

Struktura żądania FeedPost

Copy

1

2interface FeedPostsRequestQueryParams {

3 tenantId: string

4 API_KEY: string

5 /** Zwróć posty po tym identyfikatorze posta. Pomiń dla pierwszej strony. **/

6 afterId?: string

7 /** Domyślnie 10. Maksymalnie 1000. **/

8 limit?: number

9 /** Zwróć tylko posty z tymi tagami. Powtórz parametr, aby podać więcej niż jeden tag. **/

10 tags?: string[]

11}

12

Struktura odpowiedzi FeedPost

Copy

1

2interface FeedPostsResponse {

3 status: 'success' | 'failed'

4 /** Zawarte w przypadku niepowodzenia. **/

5 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'limit-invalid' | 'internal'

6 /** Zawarte w przypadku niepowodzenia. **/

7 reason?: string

8 feedPosts: FeedPost[]

9}

10

Ta trasa tworzy pojedynczy FeedPost. Każdy post ma autora, więc fromUserId jest wymagane i musi być identyfikatorem istniejącego użytkownika FastComments lub SSO na koncie.

Przykład cURL tworzenia FeedPost

Copy

1

2curl --request POST \

3 --url 'https://fastcomments.com/api/v1/feed-posts?tenantId=demo&isLive=true&API_KEY=DEMO_API_SECRET' \

4 --header 'Content-Type: application/json' \

5 --data '{

6 "fromUserId": "some-user-id",

7 "title": "Release 2.0 is out",

8 "contentHTML": "<p>Read the notes and tell us what you think.</p>",

9 "tags": ["releases"],

10 "links": [

11 {

12 "url": "https://example.com/releases/2.0",

13 "title": "Release notes",

14 "description": "Everything that changed in 2.0."

15 }

16 ]

17}'

18

Struktura żądania tworzenia FeedPost

Copy

1

2interface FeedPostPostQueryParams {

3 tenantId: string

4 API_KEY: string

5 /** Wysyła post do kanałów otwartych w przeglądarce w tej chwili. Domyślnie false. **/

6 isLive?: boolean

7 /** Uruchamia post przez silnik antyspamowy przed zapisaniem. Domyślnie false. **/

8 doSpamCheck?: boolean

9 /** Pomija sprawdzanie powtarzającej się treści, które jest wykonywane w ramach doSpamCheck. Domyślnie false. **/

10 skipDupCheck?: boolean

11 /** Do 256 znaków. Echoowane do słuchaczy na żywo, aby klient mógł zignorować własną transmisję. **/

12 broadcastId?: string

13}

14

15interface FeedPostPostBody {

16 /** Wymagane. Identyfikator użytkownika FastComments lub SSO. **/

17 fromUserId: string

18 title?: string

19 /** HTML. Oczyszczane przy zapisie. **/

20 contentHTML?: string

21 /** Zastępuje wyświetlaną nazwę pobraną od użytkownika. **/

22 fromUserDisplayName?: string

23 tags?: string[]

24 media?: FeedPostMediaItem[]

25 links?: FeedPostLink[]

26 meta?: Record<string, string>

27}

28

Struktura odpowiedzi tworzenia FeedPost

Copy

1

2interface FeedPostPostResponse {

3 status: 'success' | 'failed'

4 /** Dołączone w przypadku niepowodzenia. **/

5 code?: 'missing-tenant-id' | 'invalid-tenant-id' | 'invalid-api-key' | 'missing-api-key' | 'missing-from-user-id' | 'invalid-user' | 'broadcast-id-too-long' | 'spam-blocked' | 'user-rate-limited' | 'internal'

6 /** Dołączone w przypadku niepowodzenia. **/

7 reason?: string

8 feedPost?: FeedPost; // Zwracamy kompletny utworzony post w przypadku sukcesu.

9}

10

Ta trasa aktualizuje pojedynczy FeedPost. Wyślij tylko pola, które chcesz zmienić.

Przykład cURL aktualizacji FeedPost

Copy

1

2curl --request PATCH \

3 --url 'https://fastcomments.com/api/v1/feed-posts/some-post-id?tenantId=demo&API_KEY=DEMO_API_SECRET' \

4 --header 'Content-Type: application/json' \

5 --data '{

6 "title": "Release 2.0.1 is out",

7 "tags": ["releases", "hotfix"]

8}'

9