Diese Seite bietet eine umfassende Referenz für die Problem-Typ-URIs, die von den Tourfold-REST-APIs verwendet werden. Sie folgen RFC 9457 und enthalten maschinenlesbare URIs.
GraphQL-Fehler sind anders aufgebaut: Sie werden im GraphQL-errors-Array zurückgegeben und nicht als HTTP-Problemdokument. Jeder Fehler trägt eine stabile Typ-URI in extensions.code; Parse- und Validierungsfehler verwenden graphql/invalid-query. Siehe GraphQL-Fehler.
Struktur der Fehlertypen
Fehlertypen folgen dieser Struktur:
- Kategoriefehler:
https://problems.tourfold.com/{error-slug} (z. B. https://problems.tourfold.com/validation-failed)
- Namespaced-Fehler:
https://problems.tourfold.com/{category}/{error-slug} (z. B. https://problems.tourfold.com/tours/tour-ended)
Allgemeine Fehler
Diese Fehler sind allgemein und können überall in der API auftreten.
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/unknown-error | Unbekannter Fehler | Ein unerwarteter Fehler ist aufgetreten | 500 |
https://problems.tourfold.com/invalid-input | Ungültige Eingabe | Die übergebene Eingabe war nicht gültig | 400 |
https://problems.tourfold.com/business-rule-violation | Verstoß gegen Geschäftsregel | Die Anfrage verletzt Geschäftsregeln | 422 |
https://problems.tourfold.com/not-found | Nicht gefunden | Die angeforderte Ressource wurde nicht gefunden | 404 |
https://problems.tourfold.com/method-not-allowed | Methode nicht erlaubt | Der Pfad existiert, unterstützt aber die angeforderte HTTP-Methode nicht. Der Allow-Header und data.supported nennen die unterstützten Methoden. | 405 |
https://problems.tourfold.com/not-acceptable | Nicht akzeptabel | Keine Darstellung der Ressource entspricht dem Accept-Header | 406 |
https://problems.tourfold.com/unsupported-media-type | Nicht unterstützter Medientyp | Der Medientyp des Request-Bodys wird nicht akzeptiert. data.content_type enthält den abgelehnten Wert und data.supported die akzeptierten Medientypen. | 415 |
https://problems.tourfold.com/authentication-required | Authentifizierung erforderlich | Gültige Authentifizierungsdaten sind erforderlich. Die Ursache steht in data.reason (token_missing, token_expired, token_invalid) und spiegelt sich im WWW-Authenticate-Header. | 401 |
https://problems.tourfold.com/access-denied | Zugriff verweigert | Sie haben keine Berechtigung, diese Aktion auszuführen. Die Ursache steht in data.reason (missing_grant, not_owner, not_member, plan_restricted, tenant_scope, self_target, wrong_actor_type, device_proof_missing, device_proof_invalid); grant-basierte Ablehnungen enthalten zusätzlich data.required_grants, wenn die erforderlichen Grants statisch bekannt sind. | 403 |
https://problems.tourfold.com/user-deactivated | Benutzer deaktiviert | Dieses Benutzerkonto ist in diesem Workspace deaktiviert. Das Token ist gültig, eine erneute Anmeldung hilft daher nicht; data.tenant_id benennt den Workspace. | 403 |
https://problems.tourfold.com/tenant-disabled | Tenant deaktiviert | Dieser Tenant ist deaktiviert | 403 |
https://problems.tourfold.com/tenant-billing-locked | Tenant durch Abrechnung gesperrt | Dieser Tenant ist gesperrt, weil die Abrechnung Aufmerksamkeit erfordert | 402 |
https://problems.tourfold.com/action-not-allowed | Aktion nicht erlaubt | Eine Funktion steht dem Aufrufer nicht zur Verfügung. Auf Plugin-Routen ist das Plugin des Tenants deaktiviert oder seine Aktivierung lässt sich nicht ermitteln: data.reason ist plan_restricted, data.plugin_name bezeichnet das Plugin und data.resolution_reason erklärt die Entscheidung. | 403 |
https://problems.tourfold.com/validation-failed | Validierung fehlgeschlagen | Ein oder mehrere Felder haben die Validierung nicht bestanden | 422 |
https://problems.tourfold.com/resource-conflict | Ressourcenkonflikt | Die Anfrage steht im Konflikt mit dem aktuellen Zustand | 409 |
https://problems.tourfold.com/rate-limit-exceeded | Rate-Limit überschritten | Rate-Limit für diesen Endpoint überschritten | 429 |
https://problems.tourfold.com/too-many-requests | Zu viele Anfragen | Zu viele Anfragen im Zeitfenster | 429 |
https://problems.tourfold.com/burst-limit-exceeded | Burst-Limit überschritten | Burst-Rate-Limit überschritten | 429 |
https://problems.tourfold.com/not-unique | Nicht eindeutig | Die übergebenen Angaben waren nicht eindeutig | 422 |
https://problems.tourfold.com/payload-too-large | Payload zu groß | Das Request-Payload überschreitet die maximal erlaubte Größe | 413 |
https://problems.tourfold.com/not-implemented | Nicht implementiert | Diese Funktion ist nicht implementiert | 501 |
https://problems.tourfold.com/upstream-service-unavailable | Upstream-Service nicht verfügbar | Ein Upstream-Service ist vorübergehend nicht verfügbar | 503 |
https://problems.tourfold.com/login-failed | Anmeldung fehlgeschlagen | Die Authentifizierungsdaten sind ungültig. Wird für einen abgelehnten Login mit Anmeldedaten zurückgegeben, im Unterschied zu einem fehlenden oder unbrauchbaren Bearer-Token (authentication-required). | 401 |
https://problems.tourfold.com/client-connection-broken | Client-Verbindung abgebrochen | Die Client-Verbindung wurde unterbrochen | 500 |
https://problems.tourfold.com/empty-collection-argument | Leeres Sammlungs-Argument | Das übergebene Sammlungs-Argument darf nicht leer sein | 422 |
Beispiele für allgemeine Fehler
{
"type": "https://problems.tourfold.com/validation-failed",
"title": "Validation failed",
"detail": "One or more fields failed validation",
"status": 422
}
{
"type": "https://problems.tourfold.com/not-found",
"title": "Not found",
"detail": "The requested resource was not found",
"status": 404
}
Definitionsfehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/definitions/schema-locked | Definitionsschema ist gesperrt | Das System oder ein Plugin besitzt das erstellte Schema der Definition. Bearbeiten oder Löschen ist verboten, auch das Ändern von Bezeichnungen oder Anzeigevorlagen; erlaubt ist nur ein Patch, der ausschließlich icon und color ändert. data.definition_slug, data.managed_by und optional data.plugin_id bezeichnen den Eigentümer; die Schreibbarkeit von Datensätzen ist davon unabhängig. | 409 |
Validierungs-Unterproblemtypen
Ein Problem validation-failed auf oberster Ebene kann ein errors[]-Array enthalten. Jeder
Eintrag verwendet eine dieser stabilen, feature-übergreifenden Typ-URIs, wenn die Standardbedeutung
passt. Sein pointer benennt das abgelehnte Request-Feld mit JSON-Pointer-Syntax.
Feature-spezifische Validierungstypen sind im Abschnitt des jeweiligen Features dokumentiert.
| Typ-URI | Bedeutung |
|---|
https://problems.tourfold.com/field-validation-error | Die Feldvalidierung ist fehlgeschlagen und kein engerer Standardtyp passt. |
https://problems.tourfold.com/field-required | Das Feld fehlt, ist null, leer oder enthält nur Leerzeichen. |
https://problems.tourfold.com/field-too-large | Ein numerischer Wert liegt über dem erlaubten Maximum. |
https://problems.tourfold.com/field-too-small | Ein numerischer Wert liegt unter dem erlaubten Minimum. |
https://problems.tourfold.com/field-size-invalid | Die Länge eines Strings oder einer Collection liegt außerhalb der erlaubten Grenzen. |
https://problems.tourfold.com/field-type-invalid | Der Wert hat den falschen JSON-Typ oder die falsche Struktur. |
https://problems.tourfold.com/field-out-of-range | Der Wert liegt außerhalb des erlaubten Feldbereichs. |
https://problems.tourfold.com/invalid-email | Der Wert ist keine gültige E-Mail-Adresse. |
https://problems.tourfold.com/invalid-phone-number | Der Wert ist keine gültige internationale Telefonnummer. |
https://problems.tourfold.com/invalid-enum-value | Der Wert gehört nicht zu den erlaubten Enum-Werten. |
https://problems.tourfold.com/not-unique | Der Wert dupliziert einen Datensatz, dessen Feld eindeutig sein muss. |
GraphQL-Fehler
Diese Fehler erscheinen innerhalb der GraphQL-Antwort, nicht als HTTP-Problemdokument: Ein
GraphQL-Fehler wird weiterhin mit HTTP 200 und einem errors-Array ausgeliefert.
Welche Fehler einen Code tragen. Jeder von Tourfold ausgelöste Fehler enthält extensions.code —
die Typ-URI, also exakt denselben Wert, den ein REST-Fehler im Feld type trägt. Daneben stehen flach title und (falls vorhanden) data; ein umschließendes
Problem-Objekt gibt es bewusst nicht, ebenso wie bei Shopify und GitHub. Der lesbare Text steht in
message und wird nicht zusätzlich als detail wiederholt.
Fehler der GraphQL-Engine selbst — ein fehlerhaftes Dokument, ein unbekanntes Feld, ein falsch
typisiertes Argument — werden um graphql/invalid-query ergänzt. Ursprüngliche Meldung, Positionen und
Engine-Klassifikation bleiben erhalten. Clients müssen jedoch keinen englischen Text auswerten, um ein
ungültiges Dokument zu erkennen.
Der Namensraum graphql/ ist nicht der gesamte Katalog. Ihn erhalten nur Fehler ohne REST-Pendant.
Alle übrigen verwenden weiterhin den Typ, den sie an anderer Stelle dieser Seite bereits haben: Ein
abgelehnter Filterwert ist validation-failed und benennt das betroffene Feld unter
extensions.errors, ein unerwarteter serverseitiger Fehler ist unknown-error. Ein Client, der die
REST-Fehler von Tourfold bereits verarbeitet, braucht für GraphQL kein zweites Vokabular.
Ein Feld status gibt es hier nicht, anders als in den REST-Tabellen auf dieser Seite. Die Antwort
wird immer mit HTTP 200 ausgeliefert, es gäbe also keinen Status zu melden; werten Sie stattdessen
code aus.
Ein Fehler kann unter extensions.errors Teilfehler auflisten. Diese tragen nur, was pro Vorkommen
variiert (code, message, path, data) und verschachteln sich nicht weiter. path adressiert ein
Feld so, wie GraphQL alles andere adressiert; dadurch mischt eine Antwort nie Feldpfade mit
JSON-Pointern. Bei der Umwandlung in ein REST-Problemdokument wird daraus ein Pointer nach RFC 6901.
| Typ-URI | Titel | Beschreibung |
|---|
https://problems.tourfold.com/graphql/invalid-query | Ungültige GraphQL-Abfrage | Das Dokument konnte nicht geparst oder gegen das Workspace-Schema validiert werden |
https://problems.tourfold.com/graphql/query-too-deep | Abfrage zu tief verschachtelt | Die Abfrage verschachtelt mehr Ebenen als die konfigurierte Maximaltiefe erlaubt |
https://problems.tourfold.com/graphql/query-too-complex | Abfrage zu komplex | Die Abfrage würde voraussichtlich mehr Datensätze laden, als das konfigurierte Budget zulässt |
https://problems.tourfold.com/graphql/query-timeout | Zeitüberschreitung bei Abfrage | Die Abfrage hat die konfigurierte Ausführungsfrist überschritten |
https://problems.tourfold.com/graphql/filter-too-deep | Filter zu tief verschachtelt | Das Argument where verschachtelt mehr Ebenen als die konfigurierte maximale Filtertiefe erlaubt |
https://problems.tourfold.com/graphql/invalid-cursor | Ungültiger Cursor | Der übergebene Paginierungs-Cursor stammt nicht von dieser API |
https://problems.tourfold.com/graphql/invalid-pagination | Ungültige Paginierungsargumente | Die übergebenen Paginierungsargumente widersprechen sich oder liegen außerhalb des zulässigen Bereichs |
Jeder Fehler nennt in data genau das, was ein Client zum Nachjustieren braucht, ohne raten zu müssen:
Tiefen- und Kostenfehler geben den gemessenen Wert neben dem Grenzwert an, query-timeout nennt die
konfigurierte Frist in timeout_ms, invalid-cursor gibt den
abgelehnten Cursor zurück, und invalid-pagination nennt die Argumente, die im Widerspruch standen.
{
"data": null,
"errors": [
{
"message": "Query is estimated to materialise 3003001 rows, above the budget of 100000. A connection multiplies its subtree by its page size — request smaller pages or select fewer nested fields.",
"extensions": {
"code": "https://problems.tourfold.com/graphql/query-too-complex",
"title": "Query too complex",
"data": { "cost": 3003001, "limit": 100000 }
}
}
]
}
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/pagination/invalid-page-number | Ungültige Seitennummer | Die Seitennummer muss nicht-negativ sein (0 oder größer) | 422 |
https://problems.tourfold.com/pagination/invalid-page-size | Ungültige Seitengröße | Die Seitengröße muss zwischen 1 und 1000 liegen | 422 |
Zeitbereich-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/time-range/from-after-to | Ungültiger Zeitbereich | Der Parameter from muss vor dem Parameter to liegen | 422 |
Activity-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/activities/wrong-activity-type | Falscher Activity-Typ | Falscher Activity-Typ | 422 |
KI-Assistent-Fehler
Diese Fehler stammen vom integrierten KI-Assistenten („Ask Rob"). Sie treten sowohl als HTTP-Fehlerantworten (REST-Endpoints unter /frontend/v2/ai-assistant/...) als auch im turn.error-SSE-Event-Payload als eingebetteter ProblemDetail auf – das Wire-Format ist identisch.
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/ai-assistant/assistant-disabled | KI-Assistent ist deaktiviert | Der KI-Assistent ist für diesen Tenant deaktiviert. Ein Tenant-Administrator kann ihn in den KI-Assistent-Einstellungen wieder aktivieren. | 403 |
https://problems.tourfold.com/ai-assistant/turn-in-progress | KI-Assistent-Turn läuft bereits | Für diese Session läuft bereits ein KI-Assistent-Turn. Warten Sie, bis er beendet ist, oder brechen Sie ihn ab, bevor Sie eine neue Nachricht senden. Die konfliktverursachende sessionId ist in data enthalten. | 409 |
https://problems.tourfold.com/ai-assistant/provider-rate-limited | KI-Provider ist ausgelastet | Der KI-Assistent ist vorübergehend ausgelastet, weil der vorgeschaltete KI-Provider den Turn aus Kapazitätsgründen für den gemeinsam genutzten Schlüssel abgelehnt hat (Rate-Limit, Überlastung oder Kontingent des Kontos) — nicht wegen des eigenen Ausgabenbudgets des Tenants. Die Nachricht kann nach kurzer Wartezeit erneut gesendet werden. | 503 |
Adressfehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/addresses/opening-hours-wrong-format | Falsches Format für Öffnungszeiten | Die Öffnungszeiten haben ein falsches Zeitformat | 422 |
Filestore-/Dateifehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/filestore/file-not-found | Datei nicht gefunden | Die referenzierte Datei oder Rendition ist nicht verfügbar. | 404 |
https://problems.tourfold.com/filestore/file-deleted | Datei gelöscht | Die referenzierte Datei wurde gelöscht. | 422 |
https://problems.tourfold.com/filestore/storage-object-missing | Speicherobjekt fehlt | Die Datei ist als hochgeladen erfasst, aber das zugehörige Objekt fehlt im Speicher — eine Dateninkonsistenz, die sich von einer nie existierenden ID (404) unterscheidet. Das data-Feld benennt das betroffene Objekt: bucket, storageKey sowie — auf Rendition-Lesepfaden — fileId, renditionId, alias. | 410 |
https://problems.tourfold.com/filestore/file-not-attachable | Datei kann nicht angehängt werden | Zusammengefasster 404-Fehler für jeden Fall, in dem diese Datei nicht verwendet werden kann (ID existiert nicht, falscher Source-Key, anderer Uploader, bereits verknüpft). Die Zusammenfassung ist beabsichtigt, damit keine UUIDs preisgegeben werden. | 404 |
https://problems.tourfold.com/filestore/rendition-source-not-supported | Rendition-Quelle nicht unterstützt | Renditions können nur aus Bild- und PDF-Quellen erzeugt werden. | 422 |
https://problems.tourfold.com/filestore/rendition-target-format-not-supported | Rendition-Zielformat nicht unterstützt | Das angeforderte Zielformat wird vom quellspezifischen Rendition-Konverter nicht unterstützt. | 422 |
https://problems.tourfold.com/filestore/rendition-source-decode-failed | Rendition-Quelle konnte nicht dekodiert werden | Die Quelldatei konnte für die Rendition-Erzeugung nicht dekodiert werden (beschädigt oder nicht unterstützte Kodierung). | 422 |
https://problems.tourfold.com/filestore/rendition-pdf-empty | Rendition-Quell-PDF ist leer | Das Quell-PDF enthält keine Seiten. | 422 |
https://problems.tourfold.com/filestore/rendition-alias-reserved | Rendition-Alias ist reserviert | Der Alias original ist für die kanonische Original-Rendition reserviert. | 422 |
https://problems.tourfold.com/filestore/upload-content-empty | Upload-Inhalt ist leer | Der Upload-Payload ist leer. | 422 |
https://problems.tourfold.com/filestore/upload-mime-type-blank | MIME-Typ des Uploads fehlt | Für den Upload ist ein nicht leerer MIME-Typ erforderlich. | 422 |
https://problems.tourfold.com/filestore/upload-original-file-name-blank | Originaler Dateiname des Uploads fehlt | Für den Upload ist ein nicht leerer originaler Dateiname erforderlich. | 422 |
https://problems.tourfold.com/filestore/upload-rejected | Upload abgelehnt | Der Upload wurde beim Abschluss abgelehnt — Größe oder MIME-Typ stimmen nicht mit den angegebenen Werten überein. | 422 |
https://problems.tourfold.com/filestore/storage-purge-incomplete | Speicherbereinigung unvollständig | Eine Massenbereinigung konnte trotz Wiederholungen nicht alle passenden Objekte löschen; einige Objekte verbleiben im Speicher. Das data-Feld nennt bucket, prefix und undeletedCount. | 500 |
Nutzungsfehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/usage/limit-exceeded | Nutzungslimit überschritten | Der angeforderte Vorgang würde das konfigurierte Nutzungslimit des Tenants überschreiten | 422 |
Document-Management-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/document-management/invalid-name | Ungültiger Name | Der angegebene Ordner- oder Dokumentname ist ungültig (nach Trim leer, reservierter Name, verbotenes Zeichen oder Längengrenze überschritten). | 422 |
https://problems.tourfold.com/document-management/name-taken | Name belegt | Ein bestehender Geschwisterordner oder ein Dokument verwendet diesen Namen bereits. | 409 |
https://problems.tourfold.com/document-management/parent-not-found | Übergeordneter Ordner nicht gefunden | Der referenzierte übergeordnete Ordner existiert nicht. | 404 |
https://problems.tourfold.com/document-management/folder-not-found | Ordner nicht gefunden | Der referenzierte Ordner existiert nicht. | 404 |
https://problems.tourfold.com/document-management/move-into-descendant | Verschieben in Unterordner | Ein Ordner kann nicht in sich selbst oder einen seiner Unterordner verschoben werden. | 422 |
https://problems.tourfold.com/document-management/move-across-managed-boundary | Verschieben über verwaltete Grenze | Ein Benutzerordner kann nicht in einen verwalteten Teilbaum (z. B. /objects/...) verschoben werden, und ein verwalteter Ordner kann nicht aus einem solchen herausverschoben werden. | 400 |
https://problems.tourfold.com/document-management/invalid-move-target | Ungültiges Verschiebeziel | Der Zielordner für eine Dokumentverschiebung ist nicht zulässig (fehlt oder ist ein struktureller managed_branch-Ordner). Der Grund wird in data.reason mitgegeben. | 422 |
https://problems.tourfold.com/document-management/must-be-soft-deleted-first | Muss zuerst soft-deleted sein | Das Dokument muss zuerst soft-deleted sein (in den Papierkorb des Benutzers verschoben), bevor es dauerhaft gelöscht (hard-deleted) werden kann. | 409 |
https://problems.tourfold.com/document-management/cannot-modify-managed-folder | Verwalteter Ordner kann nicht geändert werden | Dieser Ordner wird vom System verwaltet (Objekt-Root oder System-Root) und kann nicht umbenannt, verschoben oder gelöscht werden. | 403 |
https://problems.tourfold.com/document-management/cannot-modify-soft-deleted-document | Soft-deleted-Dokument kann nicht geändert werden | Das Dokument ist soft-deleted (im Papierkorb des Benutzers) und schreibgeschützt. Nur restore und Hard-Delete sind erlaubt; Umbenennen, Beschreibung, Verschieben, Tag, Star, Upload einer neuen Version und KI-Analyse werden mit diesem Typ abgelehnt. Ordner werden im neuen Modell nicht soft-deleted, es gibt also kein Pendant für Ordner. | 409 |
https://problems.tourfold.com/document-management/document-not-found | Dokument nicht gefunden | Das referenzierte Dokument existiert nicht oder ist soft-deleted. | 404 |
https://problems.tourfold.com/document-management/version-not-found | Dokumentversion nicht gefunden | Die referenzierte Dokumentversion existiert nicht, gehört zu einem anderen Dokument oder wurde noch nicht finalisiert. | 404 |
https://problems.tourfold.com/document-management/version-mime-mismatch | MIME-Konflikt bei der Version | Eine neue Version muss denselben MIME-Typ wie das bestehende Dokument verwenden. Erwartete und tatsächliche Typen werden in data.expected und data.actual mitgegeben. | 422 |
https://problems.tourfold.com/document-management/invalid-download-rendition | Nicht unterstützte Download-Variante | Der Query-Parameter rendition muss einer der unterstützten Aliase sein. Die erlaubten Werte sind in data.allowed enthalten; der abgelehnte Wert in data.value. | 422 |
https://problems.tourfold.com/document-management/upload-initiate-failed | Upload-Start fehlgeschlagen | Der Upload konnte nicht gestartet werden. Die Ursache (Filestore-Validierung hat MIME oder Größe abgelehnt, oder ein anderer Filestore-Fehler) steht in data.cause und den Unter-Problemen der Antwort. | 422 |
https://problems.tourfold.com/document-management/upload-finalize-failed | Upload-Finalisierung fehlgeschlagen | Der Upload konnte nicht finalisiert werden. Die Ursache (fehlender Storage-Key, keine ausstehende Version oder ein Filestore-Fehler) ist in den Unter-Problemen der Antwort enthalten. | 422 |
https://problems.tourfold.com/document-management/extraction-not-found | Extraktion nicht gefunden | Die referenzierte Extraktion existiert nicht oder gehört nicht zu einem Document-Management-Dokument. | 404 |
https://problems.tourfold.com/document-management/invalid-retention-days | Ungültige Aufbewahrungsdauer | Der Aufbewahrungswert für die automatische Hard-Delete-Funktion liegt außerhalb des erlaubten Bereichs. Der abgelehnte Wert und die Grenzen werden in data.value, data.min und data.max mitgegeben. | 422 |
Aufgabenfehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/tasks/definition-in-use | Aufgabendefinition wird verwendet | Aufgaben, auch abgeschlossene, oder gespeicherte Konfigurationen verwenden diese Definition. Strukturelle Änderungen und das Löschen sind gesperrt; Bezeichnungen und zulässige optionale Ergänzungen bleiben bearbeitbar. | 409 |
https://problems.tourfold.com/tasks/required-target-in-use | Erforderliche Aufgabenbeziehung wird verwendet | Eine Aufgabe benötigt den gewählten Objekt- oder Fahrzeugdatensatz, oder erstellte Aufgabeneingaben in einer Vorlage oder einem aufbewahrten Workflow benötigen die gewählte Beziehung, den Tag, den Skill oder die Quelle des verfolgten Standorts. Das Löschen ist gesperrt, solange ein erforderlicher Verweis besteht, auch in der Historie abgeschlossener Aufgaben. | 409 |
https://problems.tourfold.com/tasks/interaction-human-required | Aufgabeninteraktion erfordert einen aktiven Menschen | Der authentifizierte Aufrufer kann keine Aufgabeninteraktionen beantworten, weil er kein aktiver menschlicher Benutzer ist. Reine API-Benutzer und Servicekonten können nicht antworten. data.reason ist not_member; zusätzliche Grants erfüllen diese Voraussetzung nicht. | 403 |
Wird von der polymorphen Comments-API unter /api/v2/comments zurückgegeben. Validierungsfehler im Body enthalten Unter-Probleme mit Verweis auf den betroffenen JSON-Pointer (#/body_markdown, #/edit_reason usw.).
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/comments/target-not-found | Ziel nicht gefunden | Die angegebene Kombination aus target_type / target_id löst sich nicht auf ein vorhandenes, für den Aufrufer sichtbares Objekt auf. Reserviert für die Phase-5-ACL-Inheritance-Prüfung; wird derzeit nicht geworfen. | 404 |
https://problems.tourfold.com/comments/parent-comment-not-found | Übergeordneter Kommentar nicht gefunden | Die angegebene parent_comment_id löst sich nicht auf einen vorhandenen Kommentar auf. | 404 |
https://problems.tourfold.com/comments/parent-target-mismatch | Übergeordneter Kommentar gehört zu einem anderen Ziel | Die angegebene parent_comment_id gehört zu einem anderen (target_type, target_id) als der neue Kommentar. | 422 |
https://problems.tourfold.com/comments/body-too-long | Kommentar-Body zu lang | body_markdown überschreitet die konfigurierte Maximallänge. Das Limit wird in data.max_length mitgegeben. | 422 |
https://problems.tourfold.com/comments/body-invalid-markdown | Kommentar-Body enthält nicht erlaubtes Markdown | body_markdown enthält Konstrukte, die nicht auf der Allow-List für Kommentare stehen (Überschriften, rohes HTML, Bilder, Nicht-http(s)-Link-Schemes usw.). Die betroffenen Konstrukte werden als Unter-Probleme mit line_number-Verweisen aufgelistet, sofern verfügbar. | 422 |
https://problems.tourfold.com/comments/comment-not-found | Kommentar nicht gefunden | Der referenzierte Kommentar existiert nicht (oder wurde hard-deleted). | 404 |
https://problems.tourfold.com/comments/cannot-edit-others | Kommentar anderer Nutzer kann nicht bearbeitet werden | Zum Bearbeiten eines fremden Kommentars wird das Grant comments:update benötigt. | 403 |
https://problems.tourfold.com/comments/cannot-delete-others | Kommentar anderer Nutzer kann nicht gelöscht werden | Zum Löschen eines fremden Kommentars wird das Grant comments:delete benötigt. | 403 |
https://problems.tourfold.com/comments/moderation-reason-required | Moderations-Edit erfordert eine Begründung | Beim Bearbeiten eines fremden Kommentars unter dem Grant comments:update ist eine nicht-leere edit_reason erforderlich. | 422 |
https://problems.tourfold.com/comments/cannot-restore-not-deleted | Kommentar ist nicht soft-deleted | Nur soft-deleted-Kommentare können wiederhergestellt werden; der referenzierte Kommentar ist aktuell aktiv. | 422 |
https://problems.tourfold.com/comments/read-cursor-target-mismatch | Kommentar gehört nicht zum angegebenen Ziel | Die comment_id in mark-read-until gehört nicht zum angegebenen (target_type, target_id). | 422 |
https://problems.tourfold.com/comments/mention-type-unknown | Unbekannter Erwähnungstyp | Ein Erwähnungs-Token verwendet ein type-Präfix, das der Server nicht kennt. | 422 |
https://problems.tourfold.com/comments/mention-target-not-found | Erwähnungsziel nicht gefunden | Im aktuellen Tenant gibt es kein Erwähnungsziel zum angegebenen (type, id). | 404 |
https://problems.tourfold.com/comments/reaction-on-deleted-comment | Reaktion auf gelöschten Kommentar nicht möglich | Der referenzierte Kommentar ist soft-deleted; Reaktionen können nur zu aktiven Kommentaren hinzugefügt werden. | 422 |
https://problems.tourfold.com/comments/reaction-not-found | Reaktion nicht gefunden | DELETE /api/v2/comments/{id}/reactions/{reaction_id} wurde mit einer ID aufgerufen, die nicht existiert oder einem anderen Benutzer gehört. Beide Fälle liefern dieselbe Antwort, damit nicht erkennbar ist, ob Reaktionen anderer Benutzer existieren. | 404 |
https://problems.tourfold.com/comments/attachment-mime-not-allowed | MIME-Typ des Anhangs ist nicht erlaubt | Der MIME-Typ der hochgeladenen Datei steht auf der Sperrliste für Kommentar-Anhänge. Der abgelehnte MIME-Typ und die vollständige Sperrliste stehen in data.mime_type und data.blocked_mime_types. | 422 |
https://problems.tourfold.com/comments/attachment-too-large | Anhang überschreitet die maximale Dateigröße | Die hochgeladene Datei überschreitet comments.attachments.max-bytes-per-file. Die angeforderte und die maximale Größe stehen in data.requested_bytes und data.max_bytes. | 422 |
https://problems.tourfold.com/comments/attachment-storage-limit-exceeded | Speicherlimit des Tenants überschritten | Der Upload würde das Speicherlimit des Tenants überschreiten. Der zugrunde liegende Billing-Problemtyp und die Mengenangaben stehen in data.underlying_problem_type und data.underlying_data. | 422 |
https://problems.tourfold.com/comments/attachment-not-found | Kommentar-Anhang nicht gefunden | Die referenzierte attachment_id existiert nicht, wurde hard-deleted oder besitzt keine Original-Rendition. | 404 |
https://problems.tourfold.com/comments/attachment-blob-gone | Blob des Anhangs wurde entfernt | GET /api/v2/comments/attachments/{attachment_id}/download-url wurde für einen Anhang aufgerufen, dessen zugrunde liegender Blob hard-deleted wurde. Der Anhang erscheint weiterhin mit is_deleted=true am Kommentar; nur das Aktualisieren der Presigned-URL gibt 410 zurück. | 410 |
https://problems.tourfold.com/comments/attachment-not-from-comments | Anhang wurde für eine andere Funktion hochgeladen | Der source_key der referenzierten Datei ist nicht COMMENT_ATTACHMENTS; die Wiederverwendung von Blobs über Funktionsgrenzen hinweg wird abgelehnt. Der tatsächliche Source-Key steht in data.source_key. | 422 |
https://problems.tourfold.com/comments/attachment-upload-incomplete | Upload des Anhangs ist noch nicht abgeschlossen | Die referenzierte Datei existiert, ihre Original-Rendition hat aber noch nicht den Status UPLOADED. Der aktuelle Status steht in data.upload_status. | 422 |
https://problems.tourfold.com/comments/attachment-mime-not-inline-previewable | Anhang kann nicht inline referenziert werden | Eine -Referenz im Body verweist auf eine Datei, deren MIME-Typ keine Inline-Vorschau erlaubt. Die Datei muss stattdessen als Anhang-Chip hinzugefügt werden. Der MIME-Typ steht in data.mime_type. | 422 |
https://problems.tourfold.com/comments/attachment-inline-not-linked | Inline-Referenz fehlt in der Anhangsliste | Der Kommentar-Body referenziert attachment:<uuid> für eine Datei, die nicht im attachment_ids-Array des Requests enthalten ist. Die erste nicht verknüpfte ID steht in data.attachment_id, die vollständige Menge in data.all_unlinked_attachment_ids. | 422 |
https://problems.tourfold.com/comments/attachment-inline-invalid-uri | Fehlerhafte attachment:-Referenz im Body | Ein Bildziel verwendet das attachment:-Schema, aber der Suffix ist keine gültige UUID. | 422 |
https://problems.tourfold.com/comments/too-many-attachments | Kommentar überschreitet die maximale Anzahl an Anhängen | Der Request enthält mehr Dateien als durch comments.attachments.max-per-comment erlaubt. Das Limit und die angeforderte Anzahl stehen in data.max_per_comment und data.requested. | 422 |
https://problems.tourfold.com/comments/attachment-already-linked | Anhang ist bereits mit einem Kommentar verknüpft | DELETE /api/v2/comments/attachments/uploads/{attachment_id} wurde für einen bereits verknüpften Anhang aufgerufen. Er muss über das Aktualisieren oder Löschen des Kommentars entfernt werden; dabei wird auch der zugrunde liegende Blob gelöscht. | 409 |
Benachrichtigungsfehler
Wird vom Benachrichtigungseingang unter /frontend/v2/notifications und von Aufrufen von NotificationEmitter.emit(...) aus anderen Funktionen zurückgegeben. invalid-action-url wird serverseitig sowohl geprüft, wenn ein Operator in der Admin-App eine Systembenachrichtigung erstellt, als auch, wenn eine Funktion eine In-App-Benachrichtigung auslöst. So kann kein fehlerhafter oder nicht mit https:// beginnender Link den Client-Renderer erreichen.
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/notifications/notification-not-found | Benachrichtigung nicht gefunden | Die referenzierte Benachrichtigung existiert nicht, ist abgelaufen oder gehört nicht dem Aufrufer. „Keine solche ID“, „abgelaufen“ und „gehört einem anderen Benutzer“ liefern dieselbe Antwort, damit nicht erkennbar ist, ob Einträge anderer Benutzer existieren. | 404 |
https://problems.tourfold.com/notifications/invalid-action-url | Aktions-URL der Benachrichtigung ist nicht erlaubt | action_url muss ein relativer Pfad mit führendem / oder eine absolute https://-URL sein. Andere Schemata (javascript:, data:, vbscript:, file:), schemarelative URLs (//evil.com/x) und fehlerhafte URIs werden abgelehnt. Der betroffene Wert steht in data.action_url. | 422 |
Fehler bei benutzerdefinierten Domains
Wird von der Workspace-API für benutzerdefinierte Domains unter /frontend/v2/custom-domains zurückgegeben. Der Endpoint verify führt die DNS-Prüfungen für TXT und CNAME aus und liefert diesen Problemtyp bei jeder Abweichung im DNS. Details je Eintrag (welcher Eintrag fehlgeschlagen ist, der erwartete Wert, die tatsächlich aufgelösten CNAME-Ziele) stehen im errors[]-Array als Unter-Probleme mit den errorType-Slugs custom-domain-txt-record-missing und custom-domain-cname-record-mismatch. Unter-Probleme sind keine eigenständigen ProblemType-Enums: Sie haben dieselbe RFC-9457-Form, gelten aber nur innerhalb des übergeordneten Problems verification-failed. Das Frontend wertet die type-URI des Unter-Problems aus, um die fehlgeschlagene Karte einzufärben.
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/custom-domains/verification-failed | Überprüfung der benutzerdefinierten Domain fehlgeschlagen | Für die Überprüfung der benutzerdefinierten Domain erforderliche DNS-Einträge fehlen oder sind falsch. errors[] enthält Unter-Probleme je Eintrag (custom-domain-txt-record-missing und/oder custom-domain-cname-record-mismatch) mit den erwarteten Werten in data.expected_record_name / data.expected_record_value / data.expected_record_target und, bei CNAME, den tatsächlich aufgelösten Zielen in data.actual_targets. Der Eintrag wird trotzdem mit status = VERIFICATION_FAILED und dem letzten last_verification_error gespeichert. | 422 |
Audit-Log-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/audit-logs/invalid-time-range | Ungültiger Zeitbereich | Der from-Zeitpunkt muss vor dem to-Zeitpunkt liegen | 422 |
https://problems.tourfold.com/audit-logs/invalid-sort | Ungültiger Sortierparameter | Sortierfeld oder -richtung wird nicht unterstützt | 422 |
Gerätefehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/devices/registered-to-another-workspace | Gerät in anderem Workspace registriert | Diese Geräte-ID ist bereits in einem anderen Workspace registriert | 409 |
https://problems.tourfold.com/devices/device-disabled | Gerät deaktiviert | Dieses Gerät ist deaktiviert und kann keine Telemetrie empfangen | 403 |
https://problems.tourfold.com/devices/keycloak-enrollment-required | Geräteregistrierung erforderlich | Dieses Gerät muss sich bei Keycloak registrieren, bevor es sich authentifizieren kann. | 401 |
https://problems.tourfold.com/devices/enrollment-challenge-invalid | Registrierungs-Challenge ungültig | Die Registrierungs-Challenge ist ungültig, abgelaufen oder wurde bereits verwendet. Fordern Sie eine neue Challenge an und versuchen Sie es erneut. | 422 |
https://problems.tourfold.com/devices/setup-link-unsupported-kind | Einrichtungslink für diese Geräteart nicht unterstützt | Einrichtungslinks werden nur für Tourfold-App-Geräte unterstützt. | 422 |
https://problems.tourfold.com/devices/setup-link-requires-admin-managed-devices | Admin-verwaltete Geräteflotte erforderlich | Einrichtungslinks können nur für Workspaces gesendet werden, deren Geräteflotte von Administratoren verwaltet wird. | 422 |
https://problems.tourfold.com/devices/self-enrollment-not-allowed | Selbstregistrierung nicht erlaubt | Dieser Workspace stellt Geräte über Einrichtungslinks von Administratoren bereit; ein Gerät kann sich nicht selbst registrieren. | 422 |
https://problems.tourfold.com/devices/current-user-association-required | Aktuelle menschliche Anmeldung erforderlich | Gültige menschliche Anmeldung und Gerätenachweis passen nicht zu der registrierten Sitzung, die der Befehl voraussetzt. Registrieren Sie die Anmeldung, bevor Sie es erneut versuchen. | 409 |
https://problems.tourfold.com/devices/user-association-changed | Benutzerzuordnung geändert | Auf dem Gerät gibt es eine neuere menschliche Anmeldung. Behalten Sie beim erneuten Abmeldeversuch die ursprünglich beobachtete Episode bei. | 409 |
https://problems.tourfold.com/devices/vehicle-association-changed | Fahrzeugzuordnung geändert | Die Fahrzeugzuordnung des Geräts entspricht nicht mehr der beobachteten Episode. Aktualisieren Sie den Kontext vor einer neuen Entscheidung. | 409 |
https://problems.tourfold.com/devices/device-token-required | Geräte-Token erforderlich | Der erforderliche zweite Nachweis fehlt (device_proof_missing), oder ein reiner Gerätevorgang hat ein menschliches primäres Token erhalten (wrong_actor_type). | 403 |
https://problems.tourfold.com/devices/device-token-invalid | Geräte-Token ungültig | Der zweite Nachweis ist unbrauchbar (device_proof_invalid), gehört zu einem anderen Workspace (tenant_scope) oder authentifiziert keinen Geräte-Principal bzw. eine nicht unterstützte Geräteart (wrong_actor_type). | 403 |
https://problems.tourfold.com/devices/device-has-active-tour | Gerät hat aktive Tour | Das Gerät ist einem Fahrzeug zugeordnet, das aktuell eine aktive Tour hat | 422 |
Document-Analyzer-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/document-analyzer/schema-invalid | Schema ist nicht gültig | Das angegebene Schema konnte nicht als JSON Schema (Draft 2020-12) interpretiert werden. | 422 |
https://problems.tourfold.com/document-analyzer/url-not-https | URL muss HTTPS verwenden | Die Dokument-URL muss HTTPS verwenden. | 422 |
https://problems.tourfold.com/document-analyzer/url-host-not-allowed | URL-Host nicht erlaubt | Der Host der Dokument-URL steht nicht auf der konfigurierten Allow-List. Senden Sie eine URL, die auf einen erlaubten Host verweist (typischerweise eine presigned Filestore-URL). | 422 |
https://problems.tourfold.com/document-analyzer/unsupported-media-type | Media-Type nicht unterstützt | Der angegebene Media-Type wird vom Document Analyzer nicht unterstützt. | 422 |
https://problems.tourfold.com/document-analyzer/url-fetch-failed | Dokument-URL konnte nicht abgerufen werden | Die Dokument-URL konnte nicht abgerufen werden. | 422 |
https://problems.tourfold.com/document-analyzer/document-too-large | Dokument ist zu groß | Das abgerufene Dokument überschreitet die maximal vom Document Analyzer erlaubte Größe. | 422 |
https://problems.tourfold.com/document-analyzer/media-type-mismatch | Dokumentinhalt entspricht nicht dem angegebenen Media-Type | Der angegebene Media-Type stimmt nicht mit dem tatsächlichen Dokumentinhalt überein. | 422 |
https://problems.tourfold.com/document-analyzer/model-output-does-not-match-schema | Modell-Ausgabe entspricht nicht dem Schema | Das Modell konnte keine Antwort erzeugen, die dem übergebenen oder abgeleiteten JSON Schema entspricht. | 422 |
https://problems.tourfold.com/document-analyzer/schema-inference-failed | Aus dem Dokument konnte kein gültiges Schema abgeleitet werden | Das Modell konnte für das Dokument kein gültiges JSON Schema (Draft 2020-12) erzeugen. Senden Sie die Anfrage erneut mit einem expliziten Schema. | 422 |
https://problems.tourfold.com/document-analyzer/provider-unavailable | Modell-Provider nicht verfügbar | Der vorgeschaltete Modell-Provider ist nicht verfügbar. Starten Sie den Job erneut; bleibt der Fehler bestehen, kontaktieren Sie den Support. | 503 |
Geocoding-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/geocoding/no-results | Keine Ergebnisse | Geocoding lieferte keine Ergebnisse | 404 |
Skill-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/skills/managed | Verwalteter Skill | System- und Plugin-Skills (managed_by ist system oder plugin) können weder umbenannt noch mit einem anderen Kurzschlüssel versehen oder gelöscht werden. | 409 |
https://problems.tourfold.com/skills/not-found | Skill nicht gefunden | Skill wurde nicht gefunden | 404 |
SMS-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/sms/gateway-rejected | SMS-Gateway hat die Nachricht abgelehnt | Der Provider hat eine Testnachricht abgelehnt: ungültige Zugangsdaten, ein ungültiger Empfänger oder Absender oder eine 4xx-Antwort eines benutzerdefinierten Endpoints. Korrigieren Sie die Gateway-Konfiguration; ein unveränderter erneuter Versuch schlägt wieder fehl. data.tracking_id verweist auf den fehlgeschlagenen (FAILED) Eintrag im SMS-Bericht, data.provider_status auf den Statuscode des Providers, sofern verfügbar. | 422 |
https://problems.tourfold.com/sms/gateway-unavailable | SMS-Gateway nicht verfügbar | Der Provider war beim Senden einer Testnachricht nicht erreichbar oder antwortete mit einem vorübergehenden Fehler (Zeitüberschreitung, 5xx, 429). Versuchen Sie es später erneut. data.tracking_id verweist auf den fehlgeschlagenen (FAILED) Eintrag im SMS-Bericht. | 503 |
Fehlertypen für Spalten gespeicherter Listenansichten
Diese erscheinen als errorType-Werte im errors-Array eines validation-failed-Problems, wenn eine
gespeicherte Listenansicht angelegt oder geändert wird. Das field jedes Eintrags ist der Feldpfad der
betroffenen Spalte. Die Validierung durchläuft verschachtelte not-/and-/or-Zweige, sodass eine
Antwort jeden fehlerhaften Filter meldet und nicht nur den ersten.
| Fehlertyp | Beschreibung |
|---|
unresolved-relation | Ein Relations-Slug im punktgetrennten Feldpfad der Spalte lässt sich von der Wurzeldefinition aus nicht auflösen |
definition-mismatch | Der Feldpfad endet mit einer Definitions-UUID, die nicht der Definition am Ende der Relationskette entspricht |
invalid-filter-operator | Der Filteroperator gehört nicht zu den unterstützten GraphQL-Filteroperatoren |
missing-filter-operator | Der Filter setzt weder op noch einen zu verneinenden not-Filter |
invalid-filter-negation | Ein Filter ohne op verneint nur seinen not-Filter und darf weder value, relative_value, and noch or setzen |
missing-filter-value | Der Filter setzt weder value noch relative_value |
ambiguous-filter-value | Der Filter setzt sowohl value als auch relative_value; beide schließen sich gegenseitig aus |
unsupported-relative-filter-operator | relative_value wurde mit einem Operator verwendet, der keine Zeitpunkte vergleichen kann. Unterstützt: _eq, _gt, _lt, _gte, _lte |
invalid-relative-time-expression | relative_value lässt sich nicht als relativer Zeitausdruck interpretieren. Siehe die Syntax für relative Zeiträume |
Fehler des Board-Layouts verwenden denselben Umschlag. Ihr pointer ist das group_by-Flag der
betroffenen Spalte (#/columns/<index>/group_by) oder, wenn keine verwendbare Gruppierungsspalte
existiert, #/layout.
| Fehlertyp | Beschreibung |
|---|
invalid-group-by-attribute | group_by ist an einer Spalte gesetzt, deren Feld weder ein state-Attribut noch ein einwertiges select-Attribut der Wurzeldefinition ist |
duplicate-group-by | Mehr als eine Spalte setzt group_by; eine Ansicht gruppiert nach höchstens einem Attribut |
missing-group-by | layout ist BOARD, aber keine Spalte setzt group_by auf ein verwendbares Attribut (weder in den übermittelten columns noch unter den gespeicherten Spalten) |
Board-Einstellungen (board) melden die oben aufgeführten Standard-Feldprobleme:
#/board/column_order/<index>:
field-type-invalid, wenn der Eintrag weder eine Auswahl-ID noch none ist;
not-unique, wenn eine Spalte doppelt aufgeführt ist.
#/board/column_order: field-size-invalid bei mehr als 100 Einträgen.
#/board/column_width: field-too-small / field-too-large außerhalb von 200–600 Pixeln.
Tag-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/tags/not-found | Tag nicht gefunden | Tag mit der angegebenen ID wurde nicht gefunden | 404 |
https://problems.tourfold.com/tags/tag-already-associated | Tag bereits zugeordnet | Dieser Tag ist bereits mit der Ressource verknüpft | 409 |
Template-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/templates/not-found | Template nicht gefunden | Template wurde nicht gefunden | 404 |
https://problems.tourfold.com/templates/rendering-error | Rendering-Fehler | Fehler beim Rendern des PDF-Templates | 500 |
https://problems.tourfold.com/templates/todo-not-found | Todo-Template nicht gefunden | Todo-Template wurde nicht gefunden | 404 |
Tenant-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/tenants/not-found | Tenant nicht gefunden | Tenant wurde nicht gefunden | 404 |
https://problems.tourfold.com/tenants/template-name-invalid | Ungültiger Template-Name | Template-Name muss mit template_ beginnen | 422 |
https://problems.tourfold.com/tenants/source-tenant-is-frozen | Quell-Tenant ist eingefroren | Ein eingefrorener Template-Tenant kann nicht als neues Template geklont werden | 422 |
https://problems.tourfold.com/tenants/realm-mode-migration-not-allowed | Migration des Realm-Modus nicht erlaubt | Unterstützt wird nur die Migration des Realm-Modus von SHARED zu DEDICATED. | 422 |
Fehler beim Zurücksetzen eines Tenants
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/tenant-reset/reset-not-allowed | Zurücksetzen nicht erlaubt | Dieser Workspace kann nicht zurückgesetzt werden. Bitten Sie zuerst einen Administrator, das Zurücksetzen zu aktivieren | 403 |
https://problems.tourfold.com/tenant-reset/active-tours-present | Laufende Touren vorhanden | In diesem Workspace laufen Touren. Schließen Sie sie ab oder brechen Sie sie ab, bevor Sie zurücksetzen | 409 |
https://problems.tourfold.com/tenant-reset/no-pending-reset-request | Keine ausstehende Anfrage zum Zurücksetzen | Es gibt kein ausstehendes Zurücksetzen, das bestätigt werden könnte. Fordern Sie zuerst einen Bestätigungscode an | 404 |
https://problems.tourfold.com/tenant-reset/invalid-confirmation-code | Ungültiger Bestätigungscode | Der angegebene Bestätigungscode ist nicht gültig | 422 |
https://problems.tourfold.com/tenant-reset/confirmation-code-expired | Bestätigungscode abgelaufen | Der Bestätigungscode ist abgelaufen. Bitte fordern Sie einen neuen an | 422 |
https://problems.tourfold.com/tenant-reset/template-not-active | Template nicht aktiv | Das gewählte Template ist nicht verfügbar. Wählen Sie eines der aktiven Templates | 422 |
https://problems.tourfold.com/tenant-reset/confirmation-email-rate-limited | Bestätigungs-E-Mails begrenzt | Bitte warten Sie, bevor Sie einen weiteren Bestätigungscode anfordern | 429 |
https://problems.tourfold.com/tenant-reset/owner-email-unavailable | E-Mail-Adresse des Eigentümers nicht verfügbar | Für den Workspace-Eigentümer ist keine E-Mail-Adresse hinterlegt, an die der Bestätigungscode gesendet werden kann | 422 |
https://problems.tourfold.com/tenant-reset/reset-failed | Zurücksetzen fehlgeschlagen | Der Workspace konnte nicht zurückgesetzt werden. Ihr Bestätigungscode ist weiterhin gültig — bitte versuchen Sie es erneut | 500 |
Tenant-Template-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/tenant-templates/template-not-found | Template nicht gefunden | Das angeforderte Tenant-Template existiert nicht | 404 |
https://problems.tourfold.com/tenant-templates/tenant-not-frozen | Tenant ist kein eingefrorenes Template | Die tenant_id_to_clone muss auf einen eingefrorenen Tenant verweisen (Name beginnt mit template_) | 422 |
Tour-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/tours/tour-ended | Tour beendet | Die Tour ist bereits beendet | 422 |
https://problems.tourfold.com/tours/no-user-associated | Kein Benutzer zugeordnet | Dieser Tour ist kein Benutzer zugeordnet | 422 |
https://problems.tourfold.com/tours/start-time-after-end | Startzeit liegt nach Endzeit | Die Startzeit muss vor dem geplanten Ende liegen | 422 |
https://problems.tourfold.com/tours/tour-has-unfinished-activities | Tour hat offene Activities | Eine Tour mit Activities im Status PENDING oder STARTED kann nicht abgeschlossen werden | 409 |
https://problems.tourfold.com/tours/tour-template-in-use | Tourenvorlage wird verwendet | Ein aktueller Workflow-Entwurf oder eine Veröffentlichung verweist auf diese Vorlage. Entfernen Sie diese Verweise und veröffentlichen Sie Ersatzversionen vor dem Löschen. Auch pausierte Workflows verhindern das Löschen; data.target_id bezeichnet die Vorlage. | 409 |
https://problems.tourfold.com/tours/template-needs-configuration | Tourenvorlage muss konfiguriert werden | Die Vorlage vor dem Erstellen einer Tour reparieren; data.tour_template_id bezeichnet die Vorlage mit fehlenden erforderlichen Eingaben. | 409 |
Generische Aufgaben-Touren
| Typ-URI | Titel | Abhilfe | HTTP-Status |
|---|
https://problems.tourfold.com/tours/default-template-protected | Standard-Tourenvorlage ist geschützt | Die geschützte Standardvorlage direkt bearbeiten; sie kann weder gelöscht werden noch ihre Standard-Identität verlieren. Schreibversuche auf das schreibgeschützte Feld is_default bleiben feldbezogene 422-Validierungsfehler. | 409 |
https://problems.tourfold.com/tours/vehicle-use-conflict | Fahrzeugnutzung der Tour hat sich geändert | Das Ersatzziel ist nicht mehr zugewiesen, oder eine Wiederholung von Start weicht vom aktuellen Fahrzeug- bzw. Quellzustand ab. Die Tour erneut lesen und für eine neue Absicht ausdrücklich den Fahrzeugbefehl der aktiven Tour verwenden. | 409 |
https://problems.tourfold.com/tours/device-active | Gerät kollidiert mit aktiver Tour-Arbeit | Eine Anmeldung oder Gerätezuweisung würde mit der laufenden Tour des Benutzers kollidieren. Ein passendes Fahrzeug bzw. Gerät wählen oder zuerst die aktive Arbeit auflösen. | 409 |
https://problems.tourfold.com/vehicle-device-associations/mode-unconfirmed | Modus der Gerätezuordnung ist unbestätigt | Eine berechtigte verwaltende Person muss bestätigen, ob das Gerät fest an ein Fahrzeug gebunden oder mobil ist, bevor eine Aktion ausgeführt wird, die von diesem Modus abhängt. | 409 |
https://problems.tourfold.com/tours/execution-forbidden | Tour-Ausführung nicht erlaubt | Als aktiver menschlicher Teilnehmer beitreten; data.reason ist not_member. | 403 |
https://problems.tourfold.com/tours/human-required | Aktiver menschlicher Benutzer erforderlich | Ein aktives menschliches Konto verwenden; zusätzliche Berechtigungen lösen diese Einschränkung nicht. | 403 |
https://problems.tourfold.com/tours/not-published | Tour nicht veröffentlicht | Vor der Ausführung veröffentlichen. | 409 |
https://problems.tourfold.com/tours/not-started | Tour nicht gestartet | Vor dem Abschließen starten. | 409 |
https://problems.tourfold.com/tours/finished | Tour abgeschlossen | Die Tour und ihre zugewiesenen Aufgaben können nicht mehr geändert werden. | 409 |
https://problems.tourfold.com/tours/already-started | Tour bereits gestartet | Löschen sowie Änderungen an Teilnehmern und geplantem Beginn sind nicht mehr erlaubt. | 409 |
https://problems.tourfold.com/tours/unfinished-work | Tour hat offene Arbeit | Aufgaben und eigenständige Stopps vor dem Abschließen erledigen oder entfernen. | 409 |
https://problems.tourfold.com/tours/vehicle-active | Fahrzeug ist in Verwendung | Die aktive Nutzung des Fahrzeugs auflösen, bevor diese Tour gestartet oder geändert wird. | 409 |
https://problems.tourfold.com/tours/vehicle-required | Fahrzeug erforderlich | Der erste Start erfordert ein geeignetes zugewiesenes Fahrzeug, weil die Tour den System-Skill Fahrzeug voraussetzt. Ein Fahrzeug auswählen und Start erneut ausführen. | 409 |
https://problems.tourfold.com/tours/vehicle-ineligible | Fahrzeug nicht geeignet | Eine zugewiesene Fahrzeugdefinition ist von Touren ausgeschlossen. Die Zuweisung ersetzen oder entfernen oder den Ausschluss vor dem ersten Start ändern. | 409 |
https://problems.tourfold.com/tours/vehicle-confirmation-required | Geplante Fahrzeugzuweisung bestätigen | Um ein Fahrzeug einzuplanen, das gerade verwendet wird, ist eine ausdrückliche Bestätigung erforderlich. data.active_use_conflicts liefert die ID jedes kollidierenden Fahrzeugs. acknowledge_active_use: true an dieser Auswahl setzen, um die geplante Zuweisung zu bestätigen; Start prüft die aktive Nutzung erneut. | 409 |
https://problems.tourfold.com/tours/participant-active | Teilnehmer bereits aktiv | Die durch data.tour_id bezeichnete Tour abschließen oder einen anderen Teilnehmer wählen. | 409 |
https://problems.tourfold.com/tours/participants-required | Teilnehmer erforderlich | Vor der Veröffentlichung Teilnehmer auswählen. | 409 |
https://problems.tourfold.com/tours/capacity-exceeded | Tour-Kapazität überschritten | Höchstens 500 Stopps und insgesamt 10000 Aufgaben und Stopps; Umfang reduzieren oder andere Tour wählen. | 409 |
https://problems.tourfold.com/tours/task-already-assigned | Aufgabe bereits zugewiesen | Die bestehende Zuweisung verschieben oder entfernen. | 409 |
https://problems.tourfold.com/tours/membership-changed | Zusammensetzung geändert | Erneut lesen und die vollständige aktuelle Reihenfolge senden. | 409 |
https://problems.tourfold.com/tours/stop-has-tasks | Stopp hat zugewiesene Aufgaben | Vor dem Löschen des Stopps seine Aufgabenzuweisungen entfernen. | 409 |
https://problems.tourfold.com/tours/task-backed-stop | Aufgaben bestimmen den Stoppstatus | Die zugewiesenen Aufgaben abschließen, statt den Stoppstatus direkt zu setzen. | 409 |
https://problems.tourfold.com/tours/same-stop | Unterschiedliche Stopps erforderlich | Verschiedene IDs für Quell- und Zielstopp wählen. | 409 |
Rollenfehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/roles/system-role-immutable | Systemrolle ist unveränderlich | Systemrollen können weder geändert noch gelöscht werden. | 409 |
https://problems.tourfold.com/roles/grant-assignment-denied | Grant-Zuweisung nicht erlaubt | Grants, die der Aufrufer nicht verwalten darf, können nicht hinzugefügt werden, und assignable_by_roles darf nicht geändert werden, wenn die transitiven editierbaren Grants der Rolle die eigenen Grants überschreiten. data.reason ist missing_grant; data.required_grants enthält die abgelehnten Grants. Bereits vorhandene, nicht verwaltbare Grants bleiben bei Änderungen erhalten. | 403 |
https://problems.tourfold.com/roles/role-assignability-update-denied | Änderung der Rollenzuweisbarkeit nicht erlaubt | Das Ändern von assignable_by_roles ist verboten, wenn der Aufrufer die Zielrolle aktuell nicht selbst zuweisen darf. data.reason ist not_member (analog zu users/role-assignment-denied), da der Aufrufer keiner Rolle angehört, die die Zielrolle zuweisen darf; data.role_id und data.role_name benennen die Rolle. | 403 |
Ein reservierter Rollenname liefert validation-failed (422) auf oberster Ebene,
mit errors[].type gleich https://problems.tourfold.com/roles/reserved-role-name und Pointer #/name.
Benutzerfehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/users/already-assigned | Benutzer bereits zugewiesen | Benutzer ist bereits zugewiesen | 422 |
https://problems.tourfold.com/users/cannot-delete-self | Sich selbst löschen nicht erlaubt | Benutzer dürfen sich nicht selbst löschen. Enthält data.reason: self_target und data.user_id. | 403 |
https://problems.tourfold.com/users/cannot-activate-self | Sich selbst aktivieren nicht erlaubt | Benutzer dürfen sich nicht selbst aktivieren. Enthält data.reason: self_target und data.user_id. | 403 |
https://problems.tourfold.com/users/cannot-deactivate-self | Sich selbst deaktivieren nicht erlaubt | Benutzer dürfen sich nicht selbst deaktivieren. Enthält data.reason: self_target und data.user_id. | 403 |
https://problems.tourfold.com/users/owner-deletion-conflict | Konflikt beim Löschen des Eigentümers | Übertragen Sie zuerst die Workspace-Eigentümerschaft. Enthält data.user_id; zusätzliche Grants lösen den Konflikt nicht. | 409 |
https://problems.tourfold.com/users/not-tenant-owner | Nicht der Workspace-Eigentümer | Nur der aktuelle Workspace-Eigentümer darf diese Aktion ausführen — etwa das Übertragen der Eigentümerschaft. Unterscheidet sich von access-denied, weil der Fehler endgültig ist: kein Grant macht aus einem Nicht-Eigentümer einen Eigentümer. Fordern Sie den Benutzer daher nicht auf, weitere Berechtigungen anzufragen. Enthält data.reason: not_owner. | 403 |
https://problems.tourfold.com/users/cannot-change-own-roles | Eigene Rollen können nicht geändert werden | Das Ändern der eigenen Rollenzuweisungen ist verboten; data.reason ist self_target. | 403 |
https://problems.tourfold.com/users/role-assignment-denied | Rollenzuweisung nicht erlaubt | Der Aufrufer darf diese Rolle nicht zuweisen; data.reason ist not_member. | 403 |
https://problems.tourfold.com/users/owner-role-change-conflict | Konflikt beim Ändern der Eigentümerrolle | Verwenden Sie die Aktion zur Übertragung der Eigentümerschaft. Normales Anlegen von Benutzern oder Ändern ihrer Rollen darf die Eigentümerrolle weder zuweisen noch entfernen. | 409 |
https://problems.tourfold.com/users/profile-self-managed | Profil wird von der Person verwaltet | Die Personen in diesem Workspace verwalten ihre firstname, lastname und phone_number selbst (is_profile_self_managed: true), weil sie diese Werte in allen ihren Workspaces teilen. Eine Benutzeraktualisierung, die diese Werte für eine andere Person ändert, wird abgelehnt (das Senden der aktuellen Werte wird akzeptiert), ebenso ein Anlegen eines Benutzers mit einem dieser Felder: laden Sie nur per E-Mail ein. Enthält data.fields (die abgelehnten Feldnamen) und bei einer Aktualisierung data.user_id. Kein Grant löst den Fehler. | 422 |
Fahrzeugfehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/vehicles/no-active-device-association | Keine aktive Gerätezuordnung | Keine aktive Fahrzeug-Geräte-Zuordnung gefunden | 422 |
https://problems.tourfold.com/vehicles/no-device-association | Keine Gerätezuordnung | Keine Fahrzeug-Geräte-Zuordnung gefunden | 422 |
https://problems.tourfold.com/vehicles/vehicle-already-assigned | Fahrzeug bereits zugewiesen | Fahrzeug ist bereits zugewiesen | 422 |
https://problems.tourfold.com/vehicles/vehicle-has-active-tour | Fahrzeug hat aktive Tour | Fahrzeug hat aktuell eine aktive Tour | 422 |
https://problems.tourfold.com/vehicles/vehicle-not-associated | Fahrzeug nicht zugeordnet | Fahrzeug ist nicht zugeordnet | 422 |
Fehler bei Fahrzeug-Anbieterverbindungen
| Typ-URI | Titel | Abhilfe | HTTP-Status |
|---|
https://problems.tourfold.com/vehicle-provider-connections/account-disabled | Anbieterkonto ist deaktiviert | Aktivieren Sie das Anbieterkonto, bevor Sie den Anbieter darüber anfragen. | 409 |
https://problems.tourfold.com/vehicle-provider-connections/authorization-already-requested | Autorisierung bereits angefragt | Die Zustimmung ist bereits ausstehend oder erteilt; fragen Sie ihren Stand erneut ab, um zu erfahren, ob sich daran etwas geändert hat. | 409 |
https://problems.tourfold.com/vehicle-provider-connections/connection-ended | Anbieterverbindung beendet | Über eine beendete Verbindung kann beim Anbieter nichts mehr angefragt werden; verbinden Sie das Fahrzeug erneut. | 409 |
https://problems.tourfold.com/vehicle-provider-connections/operation-in-progress | Anbietervorgang läuft | Warten Sie, bis der offene Vorgang derselben Art für diese Verbindung abgeschlossen ist, und fragen Sie dann erneut an. | 409 |
https://problems.tourfold.com/vehicle-provider-connections/request-id-reused | Request-ID wiederverwendet | Die request_id wurde auf dieser Verbindung für eine andere Anfrage derselben Art verwendet; senden Sie die ursprüngliche Anfrage oder eine neue request_id. | 409 |
Fehler bei Objekten und Datensätzen
Die API für Objekte und Datensätze nutzt auf oberster Ebene generische Problem-Typen (not-found, invalid-input, validation-failed, unknown-error). Der spezifische Fehlerkontext wird über Feld-Validierungs-Fehlertypen im errors-Array der Antwort transportiert.
Problem-Typen auf oberster Ebene
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/not-found | Nicht gefunden | Objekt, Datensatz, Attribut, Option, Status oder Beziehung wurde nicht gefunden | 404 |
https://problems.tourfold.com/invalid-input | Ungültige Eingabe | Der Request-Body konnte nicht geparst werden (z. B. fehlerhaftes oder nicht interpretierbares JSON) | 400 |
https://problems.tourfold.com/validation-failed | Validierung fehlgeschlagen | Validierung von Objekt, Attribut, Datensatz, Abfrage oder Berechtigung fehlgeschlagen | 422 |
https://problems.tourfold.com/resource-conflict | Ressourcenkonflikt | Die übermittelte lock_version ist veraltet | 409 |
https://problems.tourfold.com/objects/relationship-target-in-use | Relationsziel wird verwendet | Andere Objekte besitzen Relationsattribute mit diesem Ziel; data.blocking_relationships nennt sie | 409 |
https://problems.tourfold.com/objects/object-definition-in-use | Objektdefinition wird verwendet | Ein aktueller Workflow-Entwurf oder eine Veröffentlichung verweist auf diese Definition. Entfernen Sie diese Verweise und veröffentlichen Sie Ersatzversionen vor dem Löschen. Auch pausierte Workflows verhindern das Löschen; data.target_id bezeichnet die Definition. | 409 |
https://problems.tourfold.com/objects/object-attribute-in-use | Objektattribut wird verwendet | Ein aktueller Workflow-Entwurf oder eine Veröffentlichung verweist auf ein Attribut, das entfernt oder ersetzt werden soll. Entfernen Sie zuerst diese Verweise und veröffentlichen Sie Ersatzversionen. Auch pausierte Workflows verhindern das Löschen; data.target_id bezeichnet das Attribut und data.object_id sein Objekt. | 409 |
https://problems.tourfold.com/objects/count-unit-target-in-use | Zähleinheit wird verwendet | Kapazitätsattribute anderer Definitionen zählen dieses Objekt als ihre Einheit (unit_kind: object). Richten Sie sie neu aus oder entfernen Sie sie, bevor Sie das Objekt löschen; data.target_id bezeichnet das Objekt, data.reference_count und data.references[] die zählenden Attribute (die ersten 20). | 409 |
https://problems.tourfold.com/payload-too-large | Payload zu groß | Request-Payload überschreitet die maximal erlaubte Größe | 413 |
https://problems.tourfold.com/records/query-timeout | Zeitüberschreitung bei Datensatzabfrage | Eine strukturierte REST-Datensatzabfrage hat ihre Ausführungsfrist überschritten; data.timeout_ms enthält die konfigurierte Grenze | 503 |
https://problems.tourfold.com/unknown-error | Unbekannter Fehler | Ein unerwarteter Fehler ist aufgetreten (z. B. DDL-Änderungsfehler) | 500 |
Validierung typisierter Objekte und Attribute
Clients erstellen typisierte Objekte und Attribute. Die öffentliche API akzeptiert weder rohes JSON
Schema noch imperative Relationsressourcen oder einen getrennten Association-Payload. Häufige
Feldfehlertypen sind:
| Fehlertyp | Beschreibung und Pointer |
|---|
field-required | Eine Pflichteingabe fehlt; zeigt auf dieses Feld, zum Beispiel #/attributes/0/config/target. |
unknown-field | Ein unbekanntes Config-Feld wurde gesendet; zeigt auf das exakte Feld. Ausgemusterte Beziehungsfelder wie allowed_objects werden so abgelehnt. |
inapplicable-field | Ein bekanntes Config-Feld gilt nicht für den gewählten Attributtyp. |
invalid-enum-value | Eine enumartige Eingabe wie unit_kind hat einen nicht unterstützten Wert. |
invalid-slug / slug-already-exists / slug-reserved / duplicate-attribute-slug | Der Objekt- oder Attribut-Slug ist ungültig, doppelt oder reserviert. |
attribute-type-required / attribute-type-invalid | Attribut-type fehlt oder wird nicht unterstützt. |
attribute-config-missing | Der gewählte Typ benötigt config. |
unique-unsupported-type / unique-immutable | Eindeutigkeit wird für diesen Typ nicht unterstützt oder kann nach dem Anlegen nicht geändert werden. |
index-unsupported-type | Der Attributtyp kann keinen Index tragen; raw_json-Dokumente werden nie indexiert. |
display-template-unknown-attribute | display_template verweist auf ein nicht vorhandenes Attribut. |
unsupported-display-template-attribute | display_template verweist auf ein Attribut, dessen Wert keine Beschriftung hat, etwa ein raw_json-Dokument. |
raw-json-too-large / raw-json-too-deep / raw-json-too-many-items | Ein raw_json-Wert oder -Standardwert überschreitet die plattformweiten Grenzen für Größe, Verschachtelung oder Elemente; der Pointer benennt das betroffene Element, zum Beispiel #/data/payload/items. |
rich-text-unsupported-element / rich-text-unsupported-attribute / rich-text-unsafe-link | Ein rich_text-Wert oder -Standardwert verwendet Markup außerhalb der unterstützten Teilmenge, ein anderes Attribut als ein Link-href oder ein anderes Linkschema als http, https, mailto, tel. data.element und data.attribute benennen den Verursacher. |
rich-text-too-large / rich-text-too-deep | Ein rich_text-Wert oder -Standardwert überschreitet die kanonische Größen- oder Verschachtelungsgrenze. |
full-name-component-required | Ein full_name-Wert enthält einen title ohne first_name oder last_name. |
links-unsafe-link | Eine links-URL verwendet ein anderes Schema als http, https, mailto oder tel; der Pointer benennt die url des Links. |
links-primary-required | Ein links-Wert hat Alternativen, aber keinen primary-Link. |
invalid-icon | icon ist kein Icon-Schlüssel: Verwenden Sie bis zu 64 Kleinbuchstaben, Ziffern und einzelne Bindestriche. Zeigt auf #/icon. |
invalid-pattern / unacceptable-pattern | Ein Textmuster ist ungültig oder verwendet nicht unterstützte Features ohne lineare Laufzeit. |
relationship-target-not-found | Das singuläre config.target kann nicht zu einem Objekt aufgelöst werden. |
relationship-reverse-slug-conflict | reverse.slug wird bereits von einem eigenen Attribut oder einer Beziehung des Zielobjekts verwendet; der Fehler zeigt auf den kollidierenden Rückseiten-Slug. |
relationship-reverse-unsupported | Das Relationsziel akzeptiert kein verwaltetes Rückseitenattribut, etwa das System-Objekt user; zeigt auf config.reverse. |
relationship-reverse-managed | Eine verwaltete B-Rückseite wurde gesendet, aktualisiert oder gelöscht. Die Fehlerdaten nennen owner_object und owner_attribute. |
system-property-updated / system-property-deleted | Ein eingebautes Systemattribut wurde geändert oder ausgelassen. |
Ein struktureller Schutzfehler auf Objektebene ist eine validation-failed-Antwort (422) ohne
Feldfehler. System- und eingebaute Objekte beschreiben ihre Änderbarkeit in der Objektantwort; Clients
sollen sie nicht aus internen JSON-Schema-Flags ableiten.
Fehler bei Beziehungswerten
| Fehlertyp | Beschreibung |
|---|
required-relation | Ein erforderlicher Beziehungswert fehlt. |
cardinality-violation-source | Die Kardinalität der Quellseite würde überschritten. |
cardinality-violation-target | Die Kardinalität der Zielseite würde überschritten. |
object-not-found | Eine Datensatz-ID existiert nicht im konfigurierten target-Objekt. |
invalid-reference-value | Eine Tag-/Skill-ID oder ein Label kann nicht aufgelöst werden; zeigt auf das genaue Arrayelement unter #/data. |
Probleme bei Beziehungsabfragen und -Navigation
Diese namespaced Problemtypen stammen aus der Abfrage-Engine für Beziehungen. In GraphQL-Antworten
steht dieselbe URI in extensions.code; REST-Probleme verwenden sie als type.
| Typ-URI | Beschreibung |
|---|
https://problems.tourfold.com/relation/unknown-field-in-order-by | order_by nennt ein Feld, das im gewählten Objekt nicht vorhanden ist. |
https://problems.tourfold.com/relation/invalid-sort-direction | Die angeforderte Sortierrichtung wird nicht unterstützt. |
Validierung von URL, Query und Include
Auch diese Fehler liefern Feld-Pointer, obwohl die Eingabe nicht im JSON-Body steht:
| Fehlertyp | Pointer |
|---|
unknown-query-parameter | #/<parameter_name> |
unknown-relationship-attribute | #/include |
| ungültiges Sortierfeld oder ungültige Richtung | #/sort |
| unbekanntes oder nicht eindeutiges Business-Key-Attribut | #/attribute_ref |
| fehlender oder leerer Business-Key-Wert | #/attribute_value |
Fehlertypen bei Instanzvalidierung
Diese erscheinen, wenn Instanzdaten gegen das Definitions-Schema validiert werden und fehlschlagen.
| Fehlertyp | Beschreibung |
|---|
type-mismatch | Wert entspricht nicht dem erwarteten Typ |
required-field | Ein Pflichtfeld fehlt |
invalid-enum-value | Wert ist keiner der erlaubten Enum-Werte |
invalid-const-value | Wert entspricht nicht der erwarteten Konstante |
string-too-short | String-Länge unterschreitet das Minimum |
string-too-long | String-Länge überschreitet das Maximum |
pattern-mismatch | String entspricht nicht dem geforderten Pattern |
value-too-small | Numerischer Wert unterschreitet das Minimum |
value-too-large | Numerischer Wert überschreitet das Maximum |
not-multiple-of | Numerischer Wert ist kein Vielfaches des geforderten Wertes |
too-few-items | Array enthält weniger Einträge als erlaubt |
too-many-items | Array enthält mehr Einträge als erlaubt |
duplicate-items | Array enthält doppelte Einträge, obwohl Eindeutigkeit gefordert ist |
invalid-format | Wert entspricht nicht dem geforderten Format |
too-few-properties | Objekt hat weniger Eigenschaften als gefordert |
too-many-properties | Objekt hat mehr Eigenschaften als erlaubt |
additional-properties-not-allowed | Objekt enthält Eigenschaften, die im Schema nicht definiert sind |
oneOf-mismatch | Wert entspricht nicht genau einem der oneOf-Schemas |
anyOf-mismatch | Wert entspricht keinem der anyOf-Schemas |
allOf-mismatch | Wert entspricht nicht allen allOf-Schemas |
not-mismatch | Wert entspricht einem Schema, dem er nicht entsprechen soll |
conditional-mismatch | Wert erfüllt nicht ein bedingtes Schema (if/then/else) |
dependent-required | Eine abhängige Pflichteigenschaft fehlt |
dependent-schema-mismatch | Wert entspricht nicht einem abhängigen Schema |
validation-error | Generischer Validierungsfehler (Fallback) |
instance-payload-too-large | data-Payload überschreitet die konfigurierte Maximalgröße (HTTP 413). Dieser aus Kompatibilitätsgründen stabile Name des Unterfehlers gilt für Datensatz-Schreibvorgänge. Top-Level-Typ: payload-too-large. |
Beispiel für einen Fehler bei Objekten und Datensätzen
{
"type": "https://problems.tourfold.com/validation-failed",
"title": "Validation failed",
"detail": "Attribute configuration validation failed",
"status": 422,
"errors": [
{
"type": "https://problems.tourfold.com/unknown-field",
"title": "Unknown field",
"detail": "Unknown attribute configuration field 'allowed_objects'",
"pointer": "#/attributes/0/config/allowed_objects"
}
]
}
GraphQL-Fehler bei Objekten und Datensätzen
Diese Fehler treten bei der Verwendung des GraphQL-Endpoints für Objekte und Datensätze auf.
GraphQL-Fehler werden im errors-Array zurückgegeben (typischerweise mit HTTP 200 OK) und verwenden keine RFC-9457-Problem-Felder.
Welche Fehler einen Code tragen
Alles, was Tourfold an einer Abfrage ablehnt, trägt einen stabilen extensions.code — die unten
aufgeführten Limits, ein fehlerhafter Cursor, widersprüchliche Paginierungsargumente und jeder abgelehnte
Filter-Operand. Werten Sie diesen Code aus. Die vollständige Liste samt dem jeweils mitgelieferten data
finden Sie unter GraphQL-Fehler und -Limits.
Fehler der GraphQL-Engine selbst verwenden den stabilen Code
https://problems.tourfold.com/graphql/invalid-query. Die ursprüngliche Engine-Klassifikation bleibt als
informative Metadaten daneben erhalten:
| Meldungs-Muster | Bedeutung |
|---|
Validation error (FieldUndefined@...) ... Field ... is undefined | Das Feld existiert im generierten Schema Ihres Workspace nicht. Prüfen Sie den Schema-Endpoint. |
Validation error (WrongType@...) ... not a valid SortDirection | Eine order_by-Richtung außer asc oder desc. |
| Validation error (WrongType@...) ... | Ein Argumentwert passt nicht zum deklarierten Eingabetyp. |
| Invalid syntax ... | Das Dokument lässt sich nicht parsen. |
Werten Sie die Meldungsmuster in dieser Tabelle nicht aus. Sie veranschaulichen, wann
graphql/invalid-query verwendet wird; extensions.code ist der Vertrag.
Query-Validierung
| Einschränkung | Limit | Beschreibung |
|---|
| Query-Länge | 10.000 Zeichen | Maximale Länge des GraphQL-Query-Strings |
| Query-Kosten | 100.000 geschätzte Datensätze | Maximale Anzahl an Datensätzen, die eine Abfrage voraussichtlich lädt. Eine Connection multipliziert ihren Teilbaum mit ihrer Seitengröße; einfache Felder kosten 1. Bei Überschreitung: graphql/query-too-complex. |
| Query-Tiefe | 12 Ebenen | Maximale Verschachtelungstiefe, gezählt in Relay-Ebenen statt in Relationssprüngen: Eine einfache Connection kostet bereits 4, jeder To-many-Sprung weitere 3. Bei Überschreitung: graphql/query-too-deep. |
| Ausführungszeit | 10 Sekunden Gesamtzeit | Maximale Laufzeit einer Operation. Bei Überschreitung: graphql/query-timeout; kooperative Arbeit wird unterbrochen. |
Seitengröße (first/last) | 100 | Größere Werte liefern graphql/invalid-pagination mit dem übergebenen Wert und maximum. |
| Standard-Seitengröße | 20 (Wurzel), 10 (verschachtelt) | Gilt, wenn weder first noch last angegeben ist. Der verschachtelte Wert ist kleiner, weil eine verschachtelte Connection einmal pro übergeordnetem Datensatz aufgelöst wird. |
| Filter-Verschachtelungstiefe | 4 | Maximale where-Rekursionstiefe (_and / _or). Unabhängig von der Query-Tiefe. |
Relationsverschachtelung in order_by | 1 To-one-Sprung | Tiefere Pfade und die Sortierung eines Elternobjekts über eine To-many-Relation sind im erzeugten Schema nicht ausdrückbar. |
Die Query-Kosten ersetzen einen früheren Komplexitätswert von 25, der Felder zählte und damit
umgekehrt proportional zu den tatsächlichen Kosten war: Er wies eine breite Tabellenansicht zurück und
ließ zugleich eine schmale, tief paginierte Traversierung durch, die um Größenordnungen teurer ist. Eine
Antwort meldet ihre Kosten unter extensions.cost, sofern die Anfrage die Kostenanalyse erreicht hat —
erfolgreiche Ausführungen und Ablehnungen mit query-too-complex —, sodass eine Abfrage angepasst werden
kann, bevor sie abgelehnt wird. Syntax- und Validierungsfehler werden vorher erkannt und tragen keine
Kosten.
Die ausgerechnete Kostenberechnung und die Zählweise jedes Limits finden Sie unter
GraphQL-Fehler und -Limits.
Beispiel für GraphQL-Fehler bei Objekten und Datensätzen
{
"errors": [
{
"message": "Validation error (FieldUndefined@[vending_machine/cpu_processor]) : Field 'cpu_processor' in type 'vending_machine' is undefined",
"locations": [{ "line": 5, "column": 9 }],
"extensions": {
"code": "https://problems.tourfold.com/graphql/invalid-query",
"title": "Invalid GraphQL query",
"classification": "ValidationError"
}
}
]
}
Der Schlüssel data fehlt, weil die Dokumentvalidierung die Ausführung verhindert hat.
Billing-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/billing/billing-customer-missing | Billing-Kunde fehlt | Für den Tenant gibt es noch keinen Stripe-Kunden; diese Abrechnungsaktion ist daher nicht verfügbar | 422 |
https://problems.tourfold.com/billing/plan-change-in-progress | Tarifwechsel läuft | Für diesen Tenant läuft bereits ein Tarifwechsel | 409 |
https://problems.tourfold.com/billing/plan-change-not-allowed | Tarifwechsel nicht erlaubt | Im aktuellen Abrechnungszustand kann der Tarif nicht gewechselt werden | 422 |
https://problems.tourfold.com/billing/seat-cap-exceeded | Platzlimit erreicht | Der Tenant hat die im aktuellen Tarif erlaubte Höchstzahl bezahlter Plätze erreicht | 422 |
https://problems.tourfold.com/billing/stripe-billing-unavailable | Stripe-Billing nicht verfügbar | Stripe-Billing war nicht erreichbar oder konnte die Anfrage nicht verarbeiten | 503 |
https://problems.tourfold.com/billing/plan-configuration-invalid | Tarifkonfiguration ungültig | Die Stripe-Konfiguration des Tarifs ist unvollständig oder inkonsistent und kann nicht materialisiert werden (ein serverseitiger/Konfigurationszustand, kein Client-Fehler). | 500 |
Signup-Fehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/signup/email-not-verified | E-Mail nicht verifiziert | Verifizieren Sie Ihre E-Mail, bevor Sie den Signup fortsetzen | 409 |
https://problems.tourfold.com/signup/invalid-verification-code | Ungültiger Verifizierungscode | Der Verifizierungscode ist nicht gültig, oder es gibt keinen Signup für die E-Mail-Adresse; beides wird gleich beantwortet | 422 |
https://problems.tourfold.com/signup/verification-code-expired | Verifizierungscode abgelaufen | Der Verifizierungscode ist abgelaufen oder durch fünf falsche Versuche verbraucht; fordern Sie einen neuen an | 422 |
https://problems.tourfold.com/signup/subdomain-not-available | Subdomain nicht verfügbar | Die gewünschte Subdomain ist bereits vergeben | 409 |
https://problems.tourfold.com/signup/subdomain-reserved | Subdomain reserviert | Die gewünschte Subdomain ist reserviert und kann nicht verwendet werden | 409 |
https://problems.tourfold.com/signup/subdomain-invalid-format | Ungültiges Subdomain-Format | Subdomain muss 3–16 alphanumerische Kleinbuchstaben verwenden | 422 |
https://problems.tourfold.com/signup/session-not-found | Session nicht gefunden | Die Signup-Session existiert nicht | 404 |
https://problems.tourfold.com/signup/session-already-completed | Session bereits abgeschlossen | Die Signup-Session wurde bereits abgeschlossen | 409 |
https://problems.tourfold.com/signup/session-not-ready | Session nicht bereit | Alle erforderlichen Schritte müssen vor Abschluss des Signups erledigt sein | 422 |
https://problems.tourfold.com/signup/payment-pending | Zahlung ausstehend | Die Zahlung wird noch verarbeitet. Bitte warten und erneut versuchen | 409 |
https://problems.tourfold.com/signup/completion-in-progress | Signup-Abschluss läuft | Der Signup wird gerade abgeschlossen. Bitte warten und erneut versuchen | 409 |
https://problems.tourfold.com/signup/payment-not-completed | Zahlung nicht abgeschlossen | Die Zahlung wurde nicht abgeschlossen | 409 |
https://problems.tourfold.com/signup/payment-failed | Zahlung fehlgeschlagen | Die Zahlung ist fehlgeschlagen. Bitte einen Tarif wählen und erneut versuchen | 409 |
https://problems.tourfold.com/signup/email-rate-limited | E-Mail-Rate begrenzt | Zu viele Verifizierungsanfragen in kurzer Zeit | 429 |
https://problems.tourfold.com/signup/invalid-invite-code | Ungültiger Einladungscode | Der angegebene Einladungscode ist nicht gültig | 422 |
https://problems.tourfold.com/signup/email-sending-failed | E-Mail-Versand fehlgeschlagen | Die Verifizierungs-E-Mail konnte nicht gesendet werden | 503 |
https://problems.tourfold.com/signup/tenant-creation-failed | Tenant-Erstellung fehlgeschlagen | Die Plattform konnte für diesen Signup keinen Tenant erstellen | 500 |
https://problems.tourfold.com/signup/account-link-required | Kontoverknüpfung erforderlich | Zur verifizierten E-Mail-Adresse gibt es bereits ein Tourfold-Konto (account_state: EXISTING_ACCOUNT). Melden Sie sich damit an und verknüpfen Sie es (POST /frontend/v2/signup/{session_id}/account-link), bevor Sie die Kontodaten oder einen späteren Schritt eingeben. Wird auch vor dem Checkout oder dem Abschluss geliefert, wenn seit der E-Mail-Verifizierung ein Konto für die Adresse in Gebrauch genommen wurde; die Session steht dann wieder bei ACCOUNT_DETAILS. | 409 |
https://problems.tourfold.com/signup/account-link-rejected | Kontoverknüpfung abgelehnt | Das Access-Token belegt nicht das Konto des Signups; nichts wird verknüpft. data.reason: token_rejected (kein gültiges, frisches Access-Token des Signup-Clients) oder account_mismatch (das Token gehört zu einem anderen Konto als der E-Mail-Adresse des Signups). Melden Sie sich erneut mit dem Konto dieser E-Mail-Adresse an. | 403 |
https://problems.tourfold.com/signup/account-profile-incomplete | Kontoprofil unvollständig | Das Konto hat keinen Vor- oder Nachnamen, den der Workspace-Eigentümer braucht. Vervollständigen Sie das Profil in der Anmeldung und verknüpfen Sie erneut. | 422 |
Kapazitätsfehler
| Typ-URI | Titel | Beschreibung | HTTP-Status |
|---|
https://problems.tourfold.com/capacity/not-found | Maßeinheit nicht gefunden | Maßeinheit wurde nicht gefunden | 404 |
https://problems.tourfold.com/capacity/measure-unit-in-use | Maßeinheit wird verwendet | Attribute von Objekt-, Aufgaben- oder Fahrzeugdefinitionen verweisen noch auf die Einheit (capacity mit unit_kind: measure oder measure). Entfernen Sie sie oder richten Sie sie neu aus, bevor Sie die Einheit löschen. data.target_id bezeichnet die Einheit; data.reference_count und data.references[] (definition_id, definition_slug, resource_owner, attribute_id, attribute_slug, attribute_type) bezeichnen die verweisenden Attribute (die ersten 20). | 409 |
Fehler individueller Plugins
Fehlertypen individueller Plugins sind in der API-Spezifikation des jeweiligen Plugins beschrieben. Für nähere Informationen und Anpassungen erreichst du uns unter sales@tourfold.com.