RawApi class

Kontrollierter Escape Hatch für kundenspezifische oder noch nicht nativ unterstützte DOCUframe-Endpunkte.

  • Base-URL, Alias, Header, Session, Logging und Timeouts laufen über den neuen internen Runtime.
  • ApiVersion ist verpflichtend und bestimmt das URL-Präfix (v1/v2).
  • Pfade sind relativ zur konfigurierten DOCUframe-API; absolute URLs, Pfad-Traversierung sowie eigene Versions- oder Alias-Präfixe im Pfad werden abgelehnt.
  • Die Rückgabe ist ein stabiles RawApiResponse; HTTP-Fehlerstatus werden zurückgegeben, nicht geworfen. Recoverbare DOCUframe-Sessionfehler (201, 204, 341) lösen bei vorhandenen Login-Credentials einmalig einen Session-Refresh samt Retry aus. Transport-Fehler (Timeout, Netzwerk) werfen eine Exception.
  • Eine Raw-Antwort wird nicht in fachliche Modelle gemappt. Jeder dokumentierte V1-/V2-Endpunkt wird weiterhin typisiert implementiert; native Endpoints dürfen RawApi nicht intern verwenden.

Constructors

RawApi(ApiRuntime runtime)
Erstellt eine RawApi auf einem bestehenden Runtime.

Properties

hashCode → int
The hash code for this object.
no setterinherited
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
request({required ApiVersion version, required ApiHttpMethod method, required String path, Map<String, String>? queryParameters, String? body, String? contentType, Map<String, String>? headers}) → Future<RawApiResponse>
Führt einen versionsgebundenen, relativen Request aus.
toString() → String
A string representation of this object.
inherited

Operators

operator ==(Object other) → bool
The equality operator.
inherited