Zum Inhalt springen
CodamAI

Einheitliche Schnittstellen und präzise Abfragen

Jedes Modell bekommt denselben Satz an Aktionen mit derselben Bedeutung. Clients bestimmen genau, welche Daten zurückkommen, und rufen Listen gefiltert, sortiert und seitenweise ab.

Ein fester Satz Aktionen je Modell

Zu jedem Modell entstehen Anlegen, Lesen, Ersetzen, Ändern, Löschen und Suchen – bei auditierten Modellen auf Wunsch auch Historie und Zurücksetzen, bei Datei-Modellen Hoch- und Herunterladen. Welche davon es gibt, schalten Sie im Hub je Modell ein. Struktur, Regeln und Rechte sind über alle Modelle gleich, und eine maschinenlesbare Schnittstellenbeschreibung zeigt, was an welchem Modell möglich ist.

Antworten und Fehler haben feste Formen. Fehler tragen einen festen Schlüssel statt eines Fließtexts. Die Meldung in der Sprache der Person erzeugt das Frontend.

Zwei Sonderformen kommen hinzu: Ein Singleton – etwa die Einstellungen einer Person – braucht keine Kennung, der Server weiß selbst, welches Objekt gemeint ist. Und bei einem abstrakten Modell findet eine einzige Suche Objekte aller Untertypen, gemeinsam sortiert und geblättert.

Reiter Endpunkte eines Modells mit den freigeschalteten Aktionen, darunter Historie und Zurücksetzen
Welche Aktionen ein Modell anbietet – hier mit Historie und Zurücksetzen, weil das Modell auditiert wird.

Genau die Felder, die Sie brauchen

Jede lesende Anfrage nennt, welche Felder zurückkommen sollen – einzeln oder per Kurzform für alle einfachen Felder. Verbundene Objekte bauen Sie gezielt aus, Ebene für Ebene, und auch Listen darin lassen sich filtern und sortieren. Die Auswahl steuert schon die Datenbankabfrage: Was nicht verlangt ist, wird nicht gelesen, und nichts wird im Hintergrund nachgeladen.

Auf jeder Ebene gelten die Rechte des Modells, in das die Anfrage hineinreicht.

Suchen, filtern, blättern

Listen fragen Sie mit einem strukturierten Filter ab:

  • Bedingungen in beliebig tief verschachtelten UND- und ODER-Gruppen
  • Vergleiche auf Gleichheit, Suchmuster, Wertelisten, leere Felder, Datums- und Zeitgrenzen sowie die Zugehörigkeit zu Listen
  • Filter und Sortierung auch über Beziehungen hinweg, etwa nach dem Ort der Firma eines Kontakts
  • mehrere Sortierkriterien und Seiten mit der Gesamtzahl der Treffer

Verlässlich lesen und schreiben

Ein Filter, den Data Management nicht anwenden kann, fällt nie still weg – die Anfrage wird abgelehnt und nennt das betroffene Feld. Ihre Bedingungen werden außerdem immer mit den Sicherheitsfiltern verknüpft: Sie können Treffer einschränken, nie erweitern.

Ersetzen beschreibt den vollständigen Zielzustand, Ändern nur die genannten Felder. Jede Anfrage ist eine Transaktion: Sie wird gespeichert, bevor die Antwort zurückgeht, oder gar nicht. Eine Erfolgsmeldung bedeutet damit „ist gespeichert“, und die Antwort zeigt den Stand, der jetzt tatsächlich in der Datenbank steht.

Wofür das im Alltag sorgt

Wer ein Modell kennt, kennt die Schnittstelle aller Modelle.

  • Frontends, Integrationen und KI-Werkzeuge arbeiten gegen dieselbe, vorhersehbare Struktur.
  • Schlanke Antworten, weil nur gelesen wird, was angefordert ist.
  • Fehler lassen sich im Client gezielt auswerten, statt Texte zu deuten.

Hintergrund zum Thema

Passt CodamAI zu Ihrem Engineering Setup?

Der ehrlichste Weg dorthin ist ein technisches Gespräch: über Ihren Stack, Ihre Delivery und die Anforderungen, die Sie nachweisen müssen.