Profilrezepte

Verwende Profil-IDs aus der tatsächlichen Antwort. Namen müssen nicht eindeutig sein und die angezeigte Profilnummer ist nicht die UUID.

Erstellen und zurücklesen

Speichere diese fiktiven Nutzdaten als profile.json. Sie erstellen eine Konfiguration, installieren aber keinen Kern und starten keinen Browser. Zum Erstellen wird profiles:write benötigt, zum Zurücklesen profiles:read.

JSON

{
  "name": "Documentation example",
  "engine": "chromium",
  "os": "windows",
  "notes": "Example profile"
}

Node.js CLI

node tabgecko.mjs request POST /api/v1/profiles profile.json
node tabgecko.mjs request GET /api/v1/profiles/PROFILE_ID

Ersetze PROFILE_ID durch die zurückgegebene id. Das OS-Feld ist eine Profileinstellung und keine Zusage, dass jede Engine-/OS-Kombination auf dem Host verfügbar ist. Frage vor dem Start /api/v1/kernels ab.

Starten, prüfen, stoppen

Node.js CLI

node tabgecko.mjs start PROFILE_ID
node tabgecko.mjs request GET /api/v1/profiles/PROFILE_ID/runtime
node tabgecko.mjs stop PROFILE_ID

Native Routen sind POST /api/v1/profiles/{id}/start mit einem JSON-Objekt und POST /api/v1/profiles/{id}/stop. Beide benötigen runtime:control. Eine Startantwort enthält profile_id, session_id, ws_endpoint und Kerninformationen. Kläre ungewisse Ergebnisse über den Runtime-Endpunkt. Starte ein bereits startendes Profil nicht wiederholt. /stop fordert ein reguläres Beenden an; /kill ist eine andere, erzwungene Operation.

POST /api/v1/profiles/{id}/start

{"urls":["https://example.com"]}

Lasse Proxy-Prüfungen aktiviert. Das optionale Flag skip_proxy_check verändert dieses Verhalten ausdrücklich und sollte keinen fehlgeschlagenen Proxytest verdecken. Debugging-Endpunkte gehören zur lokalen laufenden Sitzung; veröffentliche sie nicht.

Nur beabsichtigte Felder ändern

PATCH /api/v1/profiles/{id}

{"notes":"Updated documentation example"}

Lies das Profil zuerst, ändere nur die gewünschten Felder und lies es erneut. Ein ausgelassenes Feld und ausdrückliches null sind nicht austauschbar. Kopiere keine vollständige Leseantwort in PATCH: Sie enthält generierte Felder. Stapeloperationen haben eigene Schemas und Einzelergebnisse. Profile löschen, Speicher leeren und Fingerprints neu erzeugen sind getrennte Änderungen, keine Voraussetzungen für normales Starten/Stoppen.