FastComments Java SDK

Geef je code‑agent de FastComments‑context die hij nodig heeft - widgets, configuratie, Secure SSO, de REST‑API en de SDK’s:

npx skills add fastcomments/skills

Werkt met Claude Code, Codex, Cursor, Copilot, Gemini en elke andere agent die de skills CLI ondersteunt.

Maven

Voeg de Repsy-repository toe aan de POM van je project:

<repositories>
    <repository>
        <id>repsy</id>
        <name>FastComments Maven Repository on Repsy</name>
        <url>https://repo.repsy.io/mvn/winrid/fastcomments</url>
    </repository>
</repositories>

Voeg vervolgens de benodigde dependencies toe:

<dependencies>
    <!-- API-client -->
    <dependency>
        <groupId>com.fastcomments</groupId>
        <artifactId>client</artifactId>
        <version>3.0.1</version>
    </dependency>
    
    <!-- Core-bibliotheek (inclusief SSO) -->
    <dependency>
        <groupId>com.fastcomments</groupId>
        <artifactId>core</artifactId>
        <version>3.0.1</version>
    </dependency>
    
    <!-- PubSub-bibliotheek (voor live‑evenementen) -->
    <dependency>
        <groupId>com.fastcomments</groupId>
        <artifactId>pubsub</artifactId>
        <version>3.0.1</version>
    </dependency>
</dependencies>

Gradle

Voeg de Repsy-repository toe aan je build.gradle‑bestand:

repositories {
    mavenCentral()
    maven {
        url "https://repo.repsy.io/mvn/winrid/fastcomments"
    }
}

dependencies {
    // API-client
    implementation "com.fastcomments:client:3.0.1"
    
    // Core-bibliotheek (inclusief SSO)
    implementation "com.fastcomments:core:3.0.1"
    
    // PubSub-bibliotheek (voor live‑evenementen)
    implementation "com.fastcomments:pubsub:3.0.1"
}

Library Contents

Deze bibliotheek bevat drie modules: de gegenereerde API‑client, de core‑Java‑bibliotheek die handgeschreven hulpprogramma’s bevat om het werken met de API te vergemakkelijken, en de pubsub‑module, een bibliotheek voor het abonneren op wijzigingsfeeds.

• API-clientbibliotheekdocumentatie
• Core-bibliotheekdocumentatie, inclusief SSO‑voorbeelden
• PubSubscriptie‑bibliotheekdocumentatie

Public vs Secured APIs

Voor de API‑client zijn er drie klassen: DefaultApi, PublicApi en ModerationApi. DefaultApi bevat methoden die je API‑sleutel vereisen, en PublicApi bevat methoden die rechtstreeks vanuit een browser/mobiel apparaat/etc. kunnen worden aangeroepen zonder authenticatie.

ModerationApi biedt een uitgebreide reeks live‑ en snelle moderatie‑API’s. Elke ModerationApi‑methode accepteert een sso‑parameter en kan authenticeren via SSO of een FastComments.com‑sessiecookie.

Gebruik van geauthenticeerde API's (DefaultApi)

Belangrijk: Je moet je API-sleutel instellen op de ApiClient voordat je geauthenticeerde verzoeken doet. Als je dat niet doet, zullen verzoeken mislukken met een 401-fout.

import com.fastcomments.invoker.ApiClient;
import com.fastcomments.invoker.ApiException;
import com.fastcomments.api.DefaultApi;
import com.fastcomments.model.*;

public class Example {
    public static void main(String[] args) {
        // Create and configure the API client
        ApiClient apiClient = new ApiClient();

        // REQUIRED: Set your API key (get this from your FastComments dashboard)
        apiClient.setApiKey("YOUR_API_KEY_HERE");

        // Create the API instance with the configured client
        DefaultApi api = new DefaultApi(apiClient);

        // Now you can make authenticated API calls
        try {
            // Example: Add an SSO user
            CreateAPISSOUserData userData = new CreateAPISSOUserData();
            userData.setId("user-123");
            userData.setEmail("user@example.com");
            userData.setDisplayName("John Doe");

            AddSSOUserAPIResponse response = api.addSSOUser("YOUR_TENANT_ID", userData)
                .execute();
            System.out.println("User created: " + response);

        } catch (ApiException e) {
            System.err.println("Error: " + e.getResponseBody());
            // Common errors:
            // - 401: API key is missing or invalid
            // - 400: Request validation failed
        }
    }
}

Gebruik van publieke API's (PublicApi)

Publieke endpoints vereisen geen authenticatie:

import com.fastcomments.api.PublicApi;
import com.fastcomments.invoker.ApiException;

PublicApi publicApi = new PublicApi();

try {
    var response = publicApi.getCommentsPublic("YOUR_TENANT_ID", "page-url-id")
        .execute();
    System.out.println(response);
} catch (ApiException e) {
    e.printStackTrace();
}

Gebruik van moderatie-API's (ModerationApi)

De ModerationApi stuurt het moderator-dashboard aan. Elke methode accepteert een sso-parameter die de SSO-geauthenticeerde moderator identificeert namens wie het verzoek wordt gedaan:

import com.fastcomments.api.ModerationApi;
import com.fastcomments.invoker.ApiException;
import com.fastcomments.model.*;

ModerationApi moderationApi = new ModerationApi();

try {
    // List comments awaiting moderation
    ModerationAPIGetCommentsResponse response = moderationApi.getApiComments()
        .sso("YOUR_SSO_TOKEN")
        .execute();
    System.out.println(response);
} catch (ApiException e) {
    e.printStackTrace();
}

Veelvoorkomende problemen

1. 401 "missing-api-key" error: Zorg ervoor dat je apiClient.setApiKey("YOUR_KEY") aanroept voordat je de DefaultApi-instantie aanmaakt.
2. Verkeerde API-klasse: Gebruik DefaultApi voor server-side geauthenticeerde verzoeken, PublicApi voor client-side/publieke verzoeken.
3. Null API key: De SDK zal authenticatie stilzwijgend overslaan als de API-sleutel null is, wat leidt tot 401-fouten.

Broadcast-id's

Je zult zien dat je in sommige API-aanroepen een broadcastId moet meegeven. Wanneer je events ontvangt, krijg je deze ID terug, zodat je het event kunt negeren als je van plan bent wijzigingen optimistisch aan de client toe te passen (wat je waarschijnlijk zult willen doen omdat dit de beste gebruikerservaring biedt). Geef hier een UUID mee. De ID moet uniek genoeg zijn om niet twee keer in een browsersessie voor te komen.