Docs
Docs API Keys

API Keys erstellen

Der beste Weg für serverseitige Scripte, CI/CD-Pipelines und Minecraft-Plugins. API Keys bieten dauerhaften Zugriff ohne Ablaufdatum.

Key generieren

01

Workspace

Gehe in dein Account Dashboard.

02

Creation

Navigiere zum Reiter API Keys und klicke auf "Neu erstellen".

03

Storage

Kopiere den Key sofort – er wird danach nie wieder vollständig angezeigt!

Header Integration

Sende den API Key im HTTP-Header X-API-Key mitsenden:

curl -X GET https://api.craftingstudiopro.de/v1/plugins/mein-plugin/latest \
  -H "X-API-Key: csp_De1nGehe1m3rK3y..."
                    

Java Implementation

UpdateScanner.java
public void checkUpdate(String slug, String apiKey) {
    try {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.craftingstudiopro.de/v1/plugins/" + slug + "/latest"))
            .header("X-API-Key", apiKey)
            .GET()
            .build();

        client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
            .thenApply(HttpResponse::body)
            .thenAccept(json -> {
                // Die API antwortet mit { "version": "1.0.0", "downloadUrl": "..." }
                System.out.println("Update gefunden: " + json);
            });
    } catch (Exception e) {
        e.printStackTrace();
    }
}
                

Best Practice: Speichere den Key niemals direkt im Code. Erstelle eine config.yml für dein Plugin, damit User ihren eigenen Key eintragen können.