Start/notes.ini Parameter/DEBUG_REST_API

DEBUG_REST_API

🛠️
Parameter: DEBUG_REST_API
Kurzbeschreibung: Aktiviert Debug-Ausgaben der Domino REST API („Project Keep" / DRAPI) – protokolliert JSON-Endpoints, Token-Validierung und Laufzeitfehler.

Steckbrief

Parameter
DEBUG_REST_API
Kategorie
Logging / Debug
Komponente
Server
Verfügbar seit
12.0
Unterstützte Versionen
12.0, 14.0, 14.5, 14.5.1
GUI-Entsprechung
Nur notes.ini (keine GUI)
Mögliche Werte
0 = aus (Standard), 1 = Basis, 2 = Verbose, 3 = Trace (inkl. Payloads)

Beschreibung

Die Domino REST API (ursprünglich Project Keep, intern auch DRAPI) bietet JSON-/OpenAPI-Endpoints für CRUD-Operationen auf NSF-Datenbanken, Authentifizierung via OAuth/OIDC und Mail-/Kalender-Funktionen. DEBUG_REST_API schaltet detailliertes Tracing dieser API ein – eingehende HTTP-Requests, Endpoint-Routing, Token-Validierung, NSF-Operationen und Antworten.
Ideal bei Themen wie REST-Aufruf liefert 401/403/500, Token wird nicht akzeptiert, Endpoint nicht gefunden, Performance-Probleme einzelner Calls, unerwartetes Antwort-Schema.

Beispiel-Konfiguration

DEBUG_REST_API=2
Debug_Outfile=/local/notesdata/IBM_TECHNICAL_SUPPORT/restapi_debug.log

Hinweise & Stolperfallen

  • Stufe 3 loggt komplette Request-/Response-Payloads – sensitiv, nur temporär aktivieren.
  • Greift sofort über set config DEBUG_REST_API=...; Restart der Restapi-Task nicht zwingend.
  • Einträge erscheinen in console.log und im Debug_Outfile.
  • Komplementär zu DEBUG_OIDC, DEBUG_HTTPINOUT, DEBUG_NAMELOOKUP.
  • Bei Token-Problemen IdP-Catalog und OAuth-Konfiguration prüfen.