FastComments Java SDK

Maven

Tilføj Repsy-repositoryet til dit projekts POM:

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

Tilføj derefter de afhængigheder, du har brug for:

<dependencies>
    <!-- API-klient -->
    <dependency>
        <groupId>com.fastcomments</groupId>
        <artifactId>client</artifactId>
        <version>1.3.1</version>
    </dependency>

    <!-- Core-bibliotek (inkluderer SSO) -->
    <dependency>
        <groupId>com.fastcomments</groupId>
        <artifactId>core</artifactId>
        <version>1.3.1</version>
    </dependency>

    <!-- PubSub-bibliotek (til live-begivenheder) -->
    <dependency>
        <groupId>com.fastcomments</groupId>
        <artifactId>pubsub</artifactId>
        <version>1.3.1</version>
    </dependency>
</dependencies>

Gradle

Tilføj Repsy-repositoryet til din build.gradle-fil:

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

dependencies {
    // API-klient
    implementation "com.fastcomments:client:1.3.1"

    // Core-bibliotek (inkluderer SSO)
    implementation "com.fastcomments:core:1.3.1"

    // PubSub-bibliotek (til live-begivenheder)
    implementation "com.fastcomments:pubsub:1.3.1"
}

Bibliotekets indhold

Dette bibliotek indeholder tre moduler. Den genererede API-klient, det centrale Java-bibliotek, som indeholder håndskrevne hjælpefunktioner for at gøre arbejdet med API'et nemmere, og pubsub-modulet, som er et bibliotek til at abonnere på ændringsfeeds.

• API-klientbibliotekets dokumentation
• Core-bibliotekets dokumentation, inklusive SSO-eksempler
• PubSub-bibliotekets dokumentation

Offentlige vs. sikrede API'er

For API-klienten findes der to klasser, DefaultApi og PublicApi. DefaultApi indeholder metoder, der kræver din API-nøgle, og PublicApi indeholder API-kald, der kan foretages direkte fra en browser/mobilenhed osv. uden autentificering.

Brug af autentificerede API'er (DefaultApi)

Vigtigt: Du skal angive din API-nøgle på ApiClient før du foretager autentificerede anmodninger. Hvis du ikke gør det, vil anmodninger mislykkes med en 401-fejl.

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) {
        // Opret og konfigurer API-klienten
        ApiClient apiClient = new ApiClient();

        // PÅKRÆVET: Indstil din API-nøgle (hent den fra dit FastComments-dashboard)
        apiClient.setApiKey("YOUR_API_KEY_HERE");

        // Opret API-instanse med den konfigurerede klient
        DefaultApi api = new DefaultApi(apiClient);

        // Nu kan du lave autentificerede API-kald
        try {
            // Eksempel: Tilføj en SSO-bruger
            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());
            // Almindelige fejl:
            // - 401: API-nøgle mangler eller er ugyldig
            // - 400: Anmodningsvalidering mislykkedes
        }
    }
}

Brug af offentlige API'er (PublicApi)

Offentlige endpoints kræver ikke autentificering:

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

Almindelige problemer

1. 401 "missing-api-key" fejl: Sørg for at du kalder apiClient.setApiKey("YOUR_KEY") før du opretter DefaultApi-instanse.
2. Forkert API-klasse: Brug DefaultApi for server-side autentificerede anmodninger, PublicApi for klient-side/offentlige anmodninger.
3. Null API-nøgle: SDK'en vil stiltiende springe autentificering over, hvis API-nøglen er null, hvilket fører til 401-fejl.

Broadcast-id'er

Du vil se, at du skal sende en broadcastId i nogle API-kald. Når du modtager begivenheder, får du dette ID tilbage, så du kan ignorere begivenheden, hvis du planlægger at anvende ændringer optimistisk på klienten (hvilket du sandsynligvis vil gøre, da det giver den bedste oplevelse). Angiv en UUID her. ID'en skal være unik nok til ikke at forekomme to gange i samme browser-session.