SENAITE-Daten über die JSON-API lesen, in 30 Sekunden

Jedes SENAITE-Objekt hat eine UID, einen 32-Zeichen- Bezeichner, der über die Lebenszeit des Objekts stabil bleibt. Geben Sie der JSON-API diese UID, und Sie bekommen alles, was das Objekt über sich selbst weiß.

Der Endpunkt

Alle JSON-API-Pfade hängen an einer einzigen Basis-URL:

http://localhost:8080/senaite/@@API/senaite/v1/

Ein Objekt per UID zu holen ist ein einfaches GET:

curl -u admin:admin \
  "http://localhost:8080/senaite/@@API/senaite/v1/samples/<UID>"

Die Antwort ist ein JSON-Dokument mit jedem Feld, das das Objekt exponiert: Kunde, Probentyp, Probenahmezeitpunkt, Analysen, Workflow-Zustand. Kein SQL, keine ZODB-Queries, kein Add-on nötig.

Suchen ohne UID

Sie haben keine UID? Fragen Sie einen Katalog. Der Endpunkt samples akzeptiert Query-Parameter, die sich wie SENAITEs eingebaute Listings verhalten:

curl -u admin:admin \
  "http://localhost:8080/senaite/@@API/senaite/v1/samples?getClientSampleID=WATER-001"

Ergänzen Sie ?limit=25&b_start=25 für Paginierung (der offset-basierte b_start ist Plone-Konvention, kein page) oder ?fields=id,review_state, um die Antwort auf die gewünschten Felder zu projizieren (kommagetrennt). Der volle Feldsupport steht im technischen Training.

Warum das zählt

Die JSON-API ist der Weg, SENAITE mit allem anderen zu verbinden. Ein Kundenportal, ein Grafana-Dashboard, ein Instrumenten-Integration-Service, ein nächtlicher Export in einen Data Lake. Ein HTTP-Call entfernt, mit Authentifizierung ab Werk, und ohne eine einzige Zeile Python in SENAITE, um an die Daten zu kommen.

Wenn Ihr erstes Integrationsprojekt an einer Zope-Frage hängen bleibt, sollte es das wahrscheinlich nicht. Die JSON-API ist meist der kürzere Weg.

Für CRUD-Operationen, Paginierung und Spaltenfilterung: Das technische Trainingsmaterial hat den Rest. Jeder Endpunkt folgt derselben vorhersagbaren Form.