Authentifizierung

Jede Anfrage erfordert einen gültigen API-Schlüssel, der im Konstruktor übergeben wird. Das SDK sendet ihn automatisch als Authorization: Bearer-Header.

API-Schlüssel-Format

Schlüsselformat: Muss mit dem Präfix sk_ beginnen.

Das SDK validiert das API-Schlüssel-Format clientseitig, bevor Anfragen gesendet werden. Ein AuthenticationError wird sofort ausgelöst, wenn:

• Der API-Schlüssel fehlt oder leer ist
• Der API-Schlüssel kein String ist
• Der API-Schlüssel nicht mit sk_ beginnt

// Gültig
const sdk = new SonarSDK({ apiKey: 'sk_live_abc123', instanceName: 'demo' });

// Ungültig — löst sofort AuthenticationError aus
const sdk = new SonarSDK({ apiKey: 'invalid_key', instanceName: 'demo' });
// Fehler: API-Schlüssel muss mit "sk_" beginnen

Anfrage-Header

Jede vom SDK gesendete Anfrage enthält:

Header	Wert	Beschreibung
Authorization	Bearer sk_...	API-Schlüssel-Authentifizierung
Content-Type	application/json	Standard-Inhaltstyp
Benutzerdefinierte Header	Aus config.headers	Vom Benutzer bereitgestellte zusätzliche Header