Ihren ersten Aufruf machen
Eine Anfrage an die CaptureKit-API authentifizieren und die Antwort lesen.
Sobald Sie einen Schlüssel haben, ist die Authentifizierung nur ein einzelner Header. Diese Seite zeigt den Aufbau einer Anfrage, wie Sie den Erfolg prüfen und was zu tun ist, wenn es nicht klappt.
Antwort
{
"remaining": 42180,
"total_used": 57820,
"renewal_date": "2026-04-01"
}API-Protokolle
Die Anfrage senden
Übergeben Sie Ihren Schlüssel bei jedem Aufruf im x-api-key-Header. Der Usage-Endpunkt ist kostenlos und damit der sicherste Weg, einen neuen Schlüssel zu prüfen:
curl "https://api.capturekit.dev/v1/usage" \
-H "x-api-key: $API_KEY"const res = await fetch("https://api.capturekit.dev/v1/usage", {
headers: { "x-api-key": process.env.API_KEY },
})
if (!res.ok) throw new Error(`Request failed: ${res.status}`)
const usage = await res.json()So sieht eine erfolgreiche Usage-Antwort aus
Ein 200 vom Usage-Endpunkt bedeutet, dass der Schlüssel funktioniert. Das JSON enthält remaining (kombinierter Spielraum), die Guthaben subscription und credits, renewal_date, wenn eine Periode gilt, sowie den api_key, der den Aufruf gemacht hat — einschließlich seiner Kontingente. Dieser Aufruf kostet keine Credits.
Wenn es nicht funktioniert
| Antwort | Ursache | Lösung |
|---|---|---|
401 Invalid API Key | Der Header fehlt oder der Wert ist falsch | Prüfen Sie, ob beim Kopieren ein Leerzeichen oder Zeilenumbruch mitgekommen ist |
401 Inactive API Key | Der Schlüssel wurde deaktiviert | Aktivieren Sie ihn unter API-Schlüssel wieder oder erstellen Sie einen neuen |
401 Rate limit exceeded | Ein Kontingent des Schlüssels oder die Ratenbegrenzung Ihres Tarifs wurde erreicht | Drosseln Sie das Tempo oder erhöhen Sie die Limits des Schlüssels |
402 Payment required | Keine Credits mehr oder eine unbezahlte Rechnung | Kaufen Sie eine Aufladung, aktivieren Sie das automatische Aufladen oder begleichen Sie die Rechnung |
Setzen Sie das Timeout Ihres HTTP-Clients auf mindestens 60 Sekunden. Viele Plattform-Standardwerte liegen deutlich darunter und brechen den Aufruf ab, bevor CaptureKit geantwortet hat.