Zum Inhalt springen

Erweitert

1 Werkzeug in dieser Gruppe, jedes mit Stufe, Eigenschaften, Beschreibung und Argumenten.

Die Beschreibung für das Modell und die Argumente stehen auf Englisch, so wie das Modell sie liest.

sevdesk_api_get 

Beliebigen API-Endpunkt lesen

Lesenread-onlyidempotent

Liest einen sevDesk-Endpunkt, den kein anderes Werkzeug abdeckt. Nur lesend und nur als letzter Ausweg.

Für das Modell, auf Englisch

Last resort: a read-only GET of a sevDesk API endpoint that no other tool covers, e.g. /TextTemplate (Textvorlagen: head and foot texts), /PartUnity (units of parts), /Document (attached documents) or /Contact/{id}/getTabsItemCount. Prefer the specific tools: they check inputs, explain fields and format money and dates. Returns sevDesk's raw objects, cleaned as untrusted data: invisible characters removed, strings cut at 2,000 characters, binary content (base64 files, thumbnails), sevClient references and nesting deeper than 12 levels removed and listed in omittedFields. At most about 100 KB per call: rows beyond that are left out (omittedItems) and nextOffset continues there; answers over 1 MiB are refused, so lower limit. limit (1–1000) and offset are always sent; endpoints that do not page ignore them. Refused before anything is sent: endpoints that change data, return files or start jobs (getPdf, getXml, render, sendBy, sendByWithRender, bookAmount, enshrine, cancelInvoice, resetToDraft, resetToOpen, changeParameter, sendViaEmail, getNext…Number, names starting with save, create, update, delete, book, send or a similar verb, and everything under Export, ExportJob, Progress, Report, DocServer and SevSequence), and the query parameters token, api_key, authorization, limit, offset, countAll, download, preventSendBy, enshrine… and useNextNumber.

patherforderlichstring
API path below /api/v1, e.g. /TextTemplate or /Contact/123/getTabsItemCount: up to 6 segments of letters, digits and _, ids as plain numbers. Filters go into query.
queryoptionalobject
sevDesk query parameters (filters), at most 20, named as sevDesk names them, e.g. {"contact[id]": 5, "contact[objectName]": "Contact"} or {"depth": 1}. Booleans are sent as 1/0. sevDesk silently ignores filters it does not know.
limitoptionalinteger
Page size, 1–1000. Default: 100.
offsetoptionalinteger
Rows to skip, for paging: pass the previous result's nextOffset. Default: 0.