https://databridge.docs.dsyr.de/themen/openapi/Recent content in OpenAPI on dsyr.DataBridgeHugodehttps://databridge.docs.dsyr.de/docs/konnektoren/openapi/Mon, 01 Jan 0001 00:00:00 +0000https://databridge.docs.dsyr.de/docs/konnektoren/openapi/<p>Der OpenAPI-Konnektor verbindet die DataBridge mit einer <strong>beliebigen REST-API</strong>, für die eine OpenAPI-Spezifikation (JSON oder YAML) existiert. Anders als bei den übrigen HTTP- Konnektoren werden Pfade, Wrapper-Schlüssel (<code>{&quot;clients&quot;: [...]}</code> vs. <code>{&quot;client&quot;: {...}}</code>) und Feldtypen <strong>nicht</strong> pro Ressource fest verdrahtet, sondern zur Laufzeit aus der Spezifikation aufgelöst. Ein Mapping muss dafür lediglich <code>SourceTable</code>/<code>TargetTable</code> auf den Ressourcennamen setzen (z. B. <code>clients</code>).</p> <table> <thead> <tr> <th>Eigenschaft</th> <th>Wert</th> </tr> </thead> <tbody> <tr> <td>Lesen</td> <td>✅ unterstützt</td> </tr> <tr> <td>Schreiben (Create/Update)</td> <td>✅ unterstützt</td> </tr> <tr> <td>Löschen</td> <td>✅ unterstützt</td> </tr> <tr> <td>Aktionsaufrufe (InvokeAction)</td> <td>✅ unterstützt</td> </tr> <tr> <td>Job-Filter</td> <td>⚠️ wird als Query-String an die Liste-Anfrage angehängt (kein <code>$filter</code>-Standard, API-abhängig)</td> </tr> <tr> <td>Status</td> <td><strong>In Entwicklung / Preview</strong></td> </tr> </tbody> </table> <div class="alert alert-warning" role="alert"><div class="h4 alert-heading" role="heading">Status: in Entwicklung</div> <p>Der Konnektor befindet sich noch in aktiver Entwicklung. Die OpenAPI-Spezifikation wird über den in <code>openApiSpecUrl</code> konfigurierten Endpunkt geladen. Bekannte Einschränkungen:</p> <ul> <li>Der Diagnose-Endpunkt <code>CheckList</code> meldet für OpenAPI-Mappings fälschlich „could not find table“. Er vergleicht die Tabellennamen mit den Pfaden der Spezifikation (<code>/v1/customers</code>) statt mit den Ressourcennamen (<code>customers</code>). Auf das Lesen und Schreiben hat das keinen Einfluss.</li> <li><code>get_connector_table_schema</code> weist keinen Primärschlüssel aus. Intern erkennt der Konnektor den Schlüssel am Namen der Property (<code>id</code>, <code>Id</code>, <code>ID</code>, <code>uuid</code>, <code>key</code>).</li> </ul> </div>