Skip to content
ClawHosters ClawHosters
Anmelden Jetzt starten
Abo -25% LAUNCH-SUB
Claws -25% LAUNCH-CLAWS

API: Instanz-Details abrufen

3 min Lesezeit API Zuletzt aktualisiert 10. February 2026

Endpunkt

text 
GET /api/v1/instances/:id

Gibt detaillierte Informationen zu einer einzelnen Instanz zurück, inklusive verfügbarer Aktionen und Konfigurationsstatus.

Authentifizierung

Füge deinen API-Schlüssel im Authorization-Header hinzu:

text 
Authorization: Bearer oc_live_dein_api_schlüssel

Siehe API-Übersicht für Details zum Erstellen und Verwalten von API-Schlüsseln.

Anfrage

Ersetze :id durch die numerische Instanz-ID.

Beispiel:

bash 
curl -X GET https://clawhosters.com/api/v1/instances/42 \
  -H "Authorization: Bearer oc_live_dein_api_schlüssel" \
  -H "Content-Type: application/json"

Antwort

Erfolg (200 OK)

json 
{
  "data": {
    "id": 42,
    "name": "my-ai-bot",
    "status": "running",
    "tier": "balanced",
    "billing_mode": "daily",
    "ip_address": "2a01:4f9:0:0::abcd:1234",
    "health_status": "healthy",
    "created_at": "2026-02-05T12:34:56Z",
    "provisioned_at": "2026-02-05T12:40:22Z",
    "can_start": false,
    "can_stop": true,
    "can_restart": true,
    "subdomain_url": "my-ai-bot.clawhosters.com",
    "daily_claw_cost": 225,
    "llm_configured": true,
    "telegram_configured": true
  }
}

Antwort-Felder

Die Detail-Antwort enthält alle Felder von Instanzen auflisten, plus zusätzliche Felder:

Feld Typ Beschreibung
id integer Eindeutige Instanz-ID
name string Instanzname, der bei der Erstellung vergeben wurde
status string Aktueller Instanz-Status (siehe Instanzen auflisten für alle Status)
tier string Instanz-Tier: budget, balanced oder pro
billing_mode string daily (Claws) oder monthly (Stripe-Abonnement)
ip_address string oder null IPv6-Adresse der VPS. Null, wenn noch nicht bereitgestellt
health_status string healthy, unhealthy oder unknown
created_at string ISO-8601-Zeitstempel
provisioned_at string oder null ISO-8601-Zeitstempel, wann die Instanz betriebsbereit wurde
can_start boolean Ob die Instanz gerade gestartet werden kann
can_stop boolean Ob die Instanz gerade gestoppt werden kann
can_restart boolean Ob die Instanz gerade neu gestartet werden kann
subdomain_url string Subdomain-URL für den Web-Zugriff auf die Instanz
daily_claw_cost integer Wie viele Claws diese Instanz pro Tag kostet
llm_configured boolean Ob ein LLM-Anbieter konfiguriert ist
telegram_configured boolean Ob Telegram verbunden ist

Aktionsverfügbarkeit

Die Felder can_start, can_stop und can_restart zeigen an, welche Power-Aktionen für die Instanz in ihrem aktuellen Zustand verfügbar sind. Prüfe diese, bevor du die entsprechenden Aktions-Endpunkte aufrufst.

Instanz-Status can_start can_stop can_restart
running false true true
stopped true false false
paused false false false
provisioning false false false
error false false false

Fehlerantworten

Nicht gefunden (404)

Wird zurückgegeben, wenn die Instanz-ID nicht existiert oder einem anderen Kunden gehört.

json 
{
  "error": {
    "code": "not_found",
    "message": "Instance not found"
  }
}

Nicht autorisiert (401)

Wird zurückgegeben, wenn der API-Schlüssel fehlt, ungültig oder widerrufen ist.

json 
{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or missing API key"
  }
}

Rate-Limit überschritten (429)

Wird zurückgegeben, wenn du 100 Anfragen pro Minute überschreitest.

json 
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 42 seconds."
  }
}

Rate-Limiting

Header Beschreibung
X-RateLimit-Limit Maximale Anfragen pro Minute (100)
X-RateLimit-Remaining Verbleibende Anfragen im aktuellen Zeitfenster
X-RateLimit-Reset Unix-Zeitstempel, wann das Zeitfenster zurückgesetzt wird

Hinweise

  • Du kannst nur Instanzen sehen, die zu deinem Account gehören. Der Zugriff auf die Instanz eines anderen Kunden gibt einen 404-Fehler zurück.
  • Die daily_claw_cost spiegelt die Basiskosten des Tiers wider. Add-on-Kosten werden separat erfasst.
  • Die subdomain_url wird während der Bereitstellung zugewiesen und bleibt gleich, auch wenn die Instanz gestoppt und neu gestartet wird.
  • Die Felder llm_configured und telegram_configured helfen dir festzustellen, ob die Instanz bereit ist, Nachrichten zu verarbeiten.

Verwandte Dokumentation

Verwandte Dokumentation

API: Instanzen auflisten

Endpunkt text Copy GET /api/v1/instances Gibt alle Instanzen des ...

API: Instanz-Aktionen (Start/Stop/Neustart)

Überblick Steuere den Power-Status deiner Instanz über diese Endpunkte. Jede Aktion ändert den I...

API: Instanz löschen

Endpunkt text Copy DELETE /api/v1/instances/:id Löscht eine Insta...