Zum Hauptinhalt springen

Fehlertypen-Referenz

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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/unknown-errorUnbekannter FehlerEin unerwarteter Fehler ist aufgetreten500
https://problems.tourfold.com/invalid-inputUngültige EingabeDie übergebene Eingabe war nicht gültig400
https://problems.tourfold.com/business-rule-violationVerstoß gegen GeschäftsregelDie Anfrage verletzt Geschäftsregeln422
https://problems.tourfold.com/not-foundNicht gefundenDie angeforderte Ressource wurde nicht gefunden404
https://problems.tourfold.com/method-not-allowedMethode nicht erlaubtDer 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-acceptableNicht akzeptabelKeine Darstellung der Ressource entspricht dem Accept-Header406
https://problems.tourfold.com/unsupported-media-typeNicht unterstützter MedientypDer 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-requiredAuthentifizierung erforderlichGü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-deniedZugriff verweigertSie 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-deactivatedBenutzer deaktiviertDieses 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-disabledTenant deaktiviertDieser Tenant ist deaktiviert403
https://problems.tourfold.com/tenant-billing-lockedTenant durch Abrechnung gesperrtDieser Tenant ist gesperrt, weil die Abrechnung Aufmerksamkeit erfordert402
https://problems.tourfold.com/action-not-allowedAktion nicht erlaubtEine 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-failedValidierung fehlgeschlagenEin oder mehrere Felder haben die Validierung nicht bestanden422
https://problems.tourfold.com/resource-conflictRessourcenkonfliktDie Anfrage steht im Konflikt mit dem aktuellen Zustand409
https://problems.tourfold.com/rate-limit-exceededRate-Limit überschrittenRate-Limit für diesen Endpoint überschritten429
https://problems.tourfold.com/too-many-requestsZu viele AnfragenZu viele Anfragen im Zeitfenster429
https://problems.tourfold.com/burst-limit-exceededBurst-Limit überschrittenBurst-Rate-Limit überschritten429
https://problems.tourfold.com/not-uniqueNicht eindeutigDie übergebenen Angaben waren nicht eindeutig422
https://problems.tourfold.com/payload-too-largePayload zu großDas Request-Payload überschreitet die maximal erlaubte Größe413
https://problems.tourfold.com/not-implementedNicht implementiertDiese Funktion ist nicht implementiert501
https://problems.tourfold.com/upstream-service-unavailableUpstream-Service nicht verfügbarEin Upstream-Service ist vorübergehend nicht verfügbar503
https://problems.tourfold.com/login-failedAnmeldung fehlgeschlagenDie 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-brokenClient-Verbindung abgebrochenDie Client-Verbindung wurde unterbrochen500
https://problems.tourfold.com/empty-collection-argumentLeeres Sammlungs-ArgumentDas übergebene Sammlungs-Argument darf nicht leer sein422

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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/definitions/schema-lockedDefinitionsschema ist gesperrtDas 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-URIBedeutung
https://problems.tourfold.com/field-validation-errorDie Feldvalidierung ist fehlgeschlagen und kein engerer Standardtyp passt.
https://problems.tourfold.com/field-requiredDas Feld fehlt, ist null, leer oder enthält nur Leerzeichen.
https://problems.tourfold.com/field-too-largeEin numerischer Wert liegt über dem erlaubten Maximum.
https://problems.tourfold.com/field-too-smallEin numerischer Wert liegt unter dem erlaubten Minimum.
https://problems.tourfold.com/field-size-invalidDie Länge eines Strings oder einer Collection liegt außerhalb der erlaubten Grenzen.
https://problems.tourfold.com/field-type-invalidDer Wert hat den falschen JSON-Typ oder die falsche Struktur.
https://problems.tourfold.com/field-out-of-rangeDer Wert liegt außerhalb des erlaubten Feldbereichs.
https://problems.tourfold.com/invalid-emailDer Wert ist keine gültige E-Mail-Adresse.
https://problems.tourfold.com/invalid-phone-numberDer Wert ist keine gültige internationale Telefonnummer.
https://problems.tourfold.com/invalid-enum-valueDer Wert gehört nicht zu den erlaubten Enum-Werten.
https://problems.tourfold.com/not-uniqueDer 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-URITitelBeschreibung
https://problems.tourfold.com/graphql/invalid-queryUngültige GraphQL-AbfrageDas Dokument konnte nicht geparst oder gegen das Workspace-Schema validiert werden
https://problems.tourfold.com/graphql/query-too-deepAbfrage zu tief verschachteltDie Abfrage verschachtelt mehr Ebenen als die konfigurierte Maximaltiefe erlaubt
https://problems.tourfold.com/graphql/query-too-complexAbfrage zu komplexDie Abfrage würde voraussichtlich mehr Datensätze laden, als das konfigurierte Budget zulässt
https://problems.tourfold.com/graphql/query-timeoutZeitüberschreitung bei AbfrageDie Abfrage hat die konfigurierte Ausführungsfrist überschritten
https://problems.tourfold.com/graphql/filter-too-deepFilter zu tief verschachteltDas Argument where verschachtelt mehr Ebenen als die konfigurierte maximale Filtertiefe erlaubt
https://problems.tourfold.com/graphql/invalid-cursorUngültiger CursorDer übergebene Paginierungs-Cursor stammt nicht von dieser API
https://problems.tourfold.com/graphql/invalid-paginationUngültige PaginierungsargumenteDie ü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 }
}
}
]
}

Paginierungsfehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/pagination/invalid-page-numberUngültige SeitennummerDie Seitennummer muss nicht-negativ sein (0 oder größer)422
https://problems.tourfold.com/pagination/invalid-page-sizeUngültige SeitengrößeDie Seitengröße muss zwischen 1 und 1000 liegen422

Zeitbereich-Fehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/time-range/from-after-toUngültiger ZeitbereichDer Parameter from muss vor dem Parameter to liegen422

Activity-Fehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/activities/wrong-activity-typeFalscher Activity-TypFalscher Activity-Typ422

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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/ai-assistant/assistant-disabledKI-Assistent ist deaktiviertDer 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-progressKI-Assistent-Turn läuft bereitsFü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-limitedKI-Provider ist ausgelastetDer 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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/addresses/opening-hours-wrong-formatFalsches Format für ÖffnungszeitenDie Öffnungszeiten haben ein falsches Zeitformat422

Filestore-/Dateifehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/filestore/file-not-foundDatei nicht gefundenDie referenzierte Datei oder Rendition ist nicht verfügbar.404
https://problems.tourfold.com/filestore/file-deletedDatei gelöschtDie referenzierte Datei wurde gelöscht.422
https://problems.tourfold.com/filestore/storage-object-missingSpeicherobjekt fehltDie 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-attachableDatei kann nicht angehängt werdenZusammengefasster 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-supportedRendition-Quelle nicht unterstütztRenditions können nur aus Bild- und PDF-Quellen erzeugt werden.422
https://problems.tourfold.com/filestore/rendition-target-format-not-supportedRendition-Zielformat nicht unterstütztDas angeforderte Zielformat wird vom quellspezifischen Rendition-Konverter nicht unterstützt.422
https://problems.tourfold.com/filestore/rendition-source-decode-failedRendition-Quelle konnte nicht dekodiert werdenDie 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-emptyRendition-Quell-PDF ist leerDas Quell-PDF enthält keine Seiten.422
https://problems.tourfold.com/filestore/rendition-alias-reservedRendition-Alias ist reserviertDer Alias original ist für die kanonische Original-Rendition reserviert.422
https://problems.tourfold.com/filestore/upload-content-emptyUpload-Inhalt ist leerDer Upload-Payload ist leer.422
https://problems.tourfold.com/filestore/upload-mime-type-blankMIME-Typ des Uploads fehltFür den Upload ist ein nicht leerer MIME-Typ erforderlich.422
https://problems.tourfold.com/filestore/upload-original-file-name-blankOriginaler Dateiname des Uploads fehltFür den Upload ist ein nicht leerer originaler Dateiname erforderlich.422
https://problems.tourfold.com/filestore/upload-rejectedUpload abgelehntDer 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-incompleteSpeicherbereinigung unvollständigEine 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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/usage/limit-exceededNutzungslimit überschrittenDer angeforderte Vorgang würde das konfigurierte Nutzungslimit des Tenants überschreiten422

Document-Management-Fehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/document-management/invalid-nameUngültiger NameDer 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-takenName belegtEin bestehender Geschwisterordner oder ein Dokument verwendet diesen Namen bereits.409
https://problems.tourfold.com/document-management/parent-not-foundÜbergeordneter Ordner nicht gefundenDer referenzierte übergeordnete Ordner existiert nicht.404
https://problems.tourfold.com/document-management/folder-not-foundOrdner nicht gefundenDer referenzierte Ordner existiert nicht.404
https://problems.tourfold.com/document-management/move-into-descendantVerschieben in UnterordnerEin Ordner kann nicht in sich selbst oder einen seiner Unterordner verschoben werden.422
https://problems.tourfold.com/document-management/move-across-managed-boundaryVerschieben über verwaltete GrenzeEin 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-targetUngültiges VerschiebezielDer 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-firstMuss zuerst soft-deleted seinDas 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-folderVerwalteter Ordner kann nicht geändert werdenDieser 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-documentSoft-deleted-Dokument kann nicht geändert werdenDas 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-foundDokument nicht gefundenDas referenzierte Dokument existiert nicht oder ist soft-deleted.404
https://problems.tourfold.com/document-management/version-not-foundDokumentversion nicht gefundenDie referenzierte Dokumentversion existiert nicht, gehört zu einem anderen Dokument oder wurde noch nicht finalisiert.404
https://problems.tourfold.com/document-management/version-mime-mismatchMIME-Konflikt bei der VersionEine 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-renditionNicht unterstützte Download-VarianteDer 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-failedUpload-Start fehlgeschlagenDer 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-failedUpload-Finalisierung fehlgeschlagenDer 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-foundExtraktion nicht gefundenDie referenzierte Extraktion existiert nicht oder gehört nicht zu einem Document-Management-Dokument.404
https://problems.tourfold.com/document-management/invalid-retention-daysUngültige AufbewahrungsdauerDer 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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/tasks/definition-in-useAufgabendefinition wird verwendetAufgaben, 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-useErforderliche Aufgabenbeziehung wird verwendetEine 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-requiredAufgabeninteraktion erfordert einen aktiven MenschenDer 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

Kommentarfehler​

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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/comments/target-not-foundZiel nicht gefundenDie 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 gefundenDie 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 ZielDie 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-longKommentar-Body zu langbody_markdown überschreitet die konfigurierte Maximallänge. Das Limit wird in data.max_length mitgegeben.422
https://problems.tourfold.com/comments/body-invalid-markdownKommentar-Body enthält nicht erlaubtes Markdownbody_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-foundKommentar nicht gefundenDer referenzierte Kommentar existiert nicht (oder wurde hard-deleted).404
https://problems.tourfold.com/comments/cannot-edit-othersKommentar anderer Nutzer kann nicht bearbeitet werdenZum Bearbeiten eines fremden Kommentars wird das Grant comments:update benötigt.403
https://problems.tourfold.com/comments/cannot-delete-othersKommentar anderer Nutzer kann nicht gelöscht werdenZum Löschen eines fremden Kommentars wird das Grant comments:delete benötigt.403
https://problems.tourfold.com/comments/moderation-reason-requiredModerations-Edit erfordert eine BegründungBeim 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-deletedKommentar ist nicht soft-deletedNur soft-deleted-Kommentare können wiederhergestellt werden; der referenzierte Kommentar ist aktuell aktiv.422
https://problems.tourfold.com/comments/read-cursor-target-mismatchKommentar gehört nicht zum angegebenen ZielDie comment_id in mark-read-until gehört nicht zum angegebenen (target_type, target_id).422
https://problems.tourfold.com/comments/mention-type-unknownUnbekannter ErwähnungstypEin Erwähnungs-Token verwendet ein type-Präfix, das der Server nicht kennt.422
https://problems.tourfold.com/comments/mention-target-not-foundErwähnungsziel nicht gefundenIm aktuellen Tenant gibt es kein Erwähnungsziel zum angegebenen (type, id).404
https://problems.tourfold.com/comments/reaction-on-deleted-commentReaktion auf gelöschten Kommentar nicht möglichDer referenzierte Kommentar ist soft-deleted; Reaktionen können nur zu aktiven Kommentaren hinzugefügt werden.422
https://problems.tourfold.com/comments/reaction-not-foundReaktion nicht gefundenDELETE /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-allowedMIME-Typ des Anhangs ist nicht erlaubtDer 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-largeAnhang überschreitet die maximale DateigrößeDie 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-exceededSpeicherlimit des Tenants überschrittenDer 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-foundKommentar-Anhang nicht gefundenDie referenzierte attachment_id existiert nicht, wurde hard-deleted oder besitzt keine Original-Rendition.404
https://problems.tourfold.com/comments/attachment-blob-goneBlob des Anhangs wurde entferntGET /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-commentsAnhang wurde für eine andere Funktion hochgeladenDer 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-incompleteUpload des Anhangs ist noch nicht abgeschlossenDie 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-previewableAnhang kann nicht inline referenziert werdenEine ![alt](attachment:<uuid>)-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-linkedInline-Referenz fehlt in der AnhangslisteDer 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-uriFehlerhafte attachment:-Referenz im BodyEin Bildziel verwendet das attachment:-Schema, aber der Suffix ist keine gültige UUID.422
https://problems.tourfold.com/comments/too-many-attachmentsKommentar überschreitet die maximale Anzahl an AnhängenDer 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-linkedAnhang ist bereits mit einem Kommentar verknüpftDELETE /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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/notifications/notification-not-foundBenachrichtigung nicht gefundenDie 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-urlAktions-URL der Benachrichtigung ist nicht erlaubtaction_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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/custom-domains/verification-failedÜberprüfung der benutzerdefinierten Domain fehlgeschlagenFü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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/audit-logs/invalid-time-rangeUngültiger ZeitbereichDer from-Zeitpunkt muss vor dem to-Zeitpunkt liegen422
https://problems.tourfold.com/audit-logs/invalid-sortUngültiger SortierparameterSortierfeld oder -richtung wird nicht unterstützt422

Gerätefehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/devices/registered-to-another-workspaceGerät in anderem Workspace registriertDiese Geräte-ID ist bereits in einem anderen Workspace registriert409
https://problems.tourfold.com/devices/device-disabledGerät deaktiviertDieses Gerät ist deaktiviert und kann keine Telemetrie empfangen403
https://problems.tourfold.com/devices/keycloak-enrollment-requiredGeräteregistrierung erforderlichDieses Gerät muss sich bei Keycloak registrieren, bevor es sich authentifizieren kann.401
https://problems.tourfold.com/devices/enrollment-challenge-invalidRegistrierungs-Challenge ungültigDie 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-kindEinrichtungslink für diese Geräteart nicht unterstütztEinrichtungslinks werden nur für Tourfold-App-Geräte unterstützt.422
https://problems.tourfold.com/devices/setup-link-requires-admin-managed-devicesAdmin-verwaltete Geräteflotte erforderlichEinrichtungslinks können nur für Workspaces gesendet werden, deren Geräteflotte von Administratoren verwaltet wird.422
https://problems.tourfold.com/devices/self-enrollment-not-allowedSelbstregistrierung nicht erlaubtDieser 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-requiredAktuelle menschliche Anmeldung erforderlichGü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-changedBenutzerzuordnung geändertAuf 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-changedFahrzeugzuordnung geändertDie 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-requiredGeräte-Token erforderlichDer 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-invalidGeräte-Token ungültigDer 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-tourGerät hat aktive TourDas Gerät ist einem Fahrzeug zugeordnet, das aktuell eine aktive Tour hat422

Document-Analyzer-Fehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/document-analyzer/schema-invalidSchema ist nicht gültigDas angegebene Schema konnte nicht als JSON Schema (Draft 2020-12) interpretiert werden.422
https://problems.tourfold.com/document-analyzer/url-not-httpsURL muss HTTPS verwendenDie Dokument-URL muss HTTPS verwenden.422
https://problems.tourfold.com/document-analyzer/url-host-not-allowedURL-Host nicht erlaubtDer 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-typeMedia-Type nicht unterstütztDer angegebene Media-Type wird vom Document Analyzer nicht unterstützt.422
https://problems.tourfold.com/document-analyzer/url-fetch-failedDokument-URL konnte nicht abgerufen werdenDie Dokument-URL konnte nicht abgerufen werden.422
https://problems.tourfold.com/document-analyzer/document-too-largeDokument ist zu großDas abgerufene Dokument überschreitet die maximal vom Document Analyzer erlaubte Größe.422
https://problems.tourfold.com/document-analyzer/media-type-mismatchDokumentinhalt entspricht nicht dem angegebenen Media-TypeDer angegebene Media-Type stimmt nicht mit dem tatsächlichen Dokumentinhalt überein.422
https://problems.tourfold.com/document-analyzer/model-output-does-not-match-schemaModell-Ausgabe entspricht nicht dem SchemaDas Modell konnte keine Antwort erzeugen, die dem übergebenen oder abgeleiteten JSON Schema entspricht.422
https://problems.tourfold.com/document-analyzer/schema-inference-failedAus dem Dokument konnte kein gültiges Schema abgeleitet werdenDas 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-unavailableModell-Provider nicht verfügbarDer vorgeschaltete Modell-Provider ist nicht verfügbar. Starten Sie den Job erneut; bleibt der Fehler bestehen, kontaktieren Sie den Support.503

Geocoding-Fehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/geocoding/no-resultsKeine ErgebnisseGeocoding lieferte keine Ergebnisse404

Skill-Fehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/skills/managedVerwalteter SkillSystem- 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-foundSkill nicht gefundenSkill wurde nicht gefunden404

SMS-Fehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/sms/gateway-rejectedSMS-Gateway hat die Nachricht abgelehntDer 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-unavailableSMS-Gateway nicht verfügbarDer 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.

FehlertypBeschreibung
unresolved-relationEin Relations-Slug im punktgetrennten Feldpfad der Spalte lässt sich von der Wurzeldefinition aus nicht auflösen
definition-mismatchDer Feldpfad endet mit einer Definitions-UUID, die nicht der Definition am Ende der Relationskette entspricht
invalid-filter-operatorDer Filteroperator gehört nicht zu den unterstützten GraphQL-Filteroperatoren
missing-filter-operatorDer Filter setzt weder op noch einen zu verneinenden not-Filter
invalid-filter-negationEin Filter ohne op verneint nur seinen not-Filter und darf weder value, relative_value, and noch or setzen
missing-filter-valueDer Filter setzt weder value noch relative_value
ambiguous-filter-valueDer Filter setzt sowohl value als auch relative_value; beide schließen sich gegenseitig aus
unsupported-relative-filter-operatorrelative_value wurde mit einem Operator verwendet, der keine Zeitpunkte vergleichen kann. Unterstützt: _eq, _gt, _lt, _gte, _lte
invalid-relative-time-expressionrelative_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.

FehlertypBeschreibung
invalid-group-by-attributegroup_by ist an einer Spalte gesetzt, deren Feld weder ein state-Attribut noch ein einwertiges select-Attribut der Wurzeldefinition ist
duplicate-group-byMehr als eine Spalte setzt group_by; eine Ansicht gruppiert nach höchstens einem Attribut
missing-group-bylayout 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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/tags/not-foundTag nicht gefundenTag mit der angegebenen ID wurde nicht gefunden404
https://problems.tourfold.com/tags/tag-already-associatedTag bereits zugeordnetDieser Tag ist bereits mit der Ressource verknüpft409

Template-Fehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/templates/not-foundTemplate nicht gefundenTemplate wurde nicht gefunden404
https://problems.tourfold.com/templates/rendering-errorRendering-FehlerFehler beim Rendern des PDF-Templates500
https://problems.tourfold.com/templates/todo-not-foundTodo-Template nicht gefundenTodo-Template wurde nicht gefunden404

Tenant-Fehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/tenants/not-foundTenant nicht gefundenTenant wurde nicht gefunden404
https://problems.tourfold.com/tenants/template-name-invalidUngültiger Template-NameTemplate-Name muss mit template_ beginnen422
https://problems.tourfold.com/tenants/source-tenant-is-frozenQuell-Tenant ist eingefrorenEin eingefrorener Template-Tenant kann nicht als neues Template geklont werden422
https://problems.tourfold.com/tenants/realm-mode-migration-not-allowedMigration des Realm-Modus nicht erlaubtUnterstützt wird nur die Migration des Realm-Modus von SHARED zu DEDICATED.422

Fehler beim Zurücksetzen eines Tenants​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/tenant-reset/reset-not-allowedZurücksetzen nicht erlaubtDieser Workspace kann nicht zurückgesetzt werden. Bitten Sie zuerst einen Administrator, das Zurücksetzen zu aktivieren403
https://problems.tourfold.com/tenant-reset/active-tours-presentLaufende Touren vorhandenIn diesem Workspace laufen Touren. Schließen Sie sie ab oder brechen Sie sie ab, bevor Sie zurücksetzen409
https://problems.tourfold.com/tenant-reset/no-pending-reset-requestKeine ausstehende Anfrage zum ZurücksetzenEs gibt kein ausstehendes Zurücksetzen, das bestätigt werden könnte. Fordern Sie zuerst einen Bestätigungscode an404
https://problems.tourfold.com/tenant-reset/invalid-confirmation-codeUngültiger BestätigungscodeDer angegebene Bestätigungscode ist nicht gültig422
https://problems.tourfold.com/tenant-reset/confirmation-code-expiredBestätigungscode abgelaufenDer Bestätigungscode ist abgelaufen. Bitte fordern Sie einen neuen an422
https://problems.tourfold.com/tenant-reset/template-not-activeTemplate nicht aktivDas gewählte Template ist nicht verfügbar. Wählen Sie eines der aktiven Templates422
https://problems.tourfold.com/tenant-reset/confirmation-email-rate-limitedBestätigungs-E-Mails begrenztBitte warten Sie, bevor Sie einen weiteren Bestätigungscode anfordern429
https://problems.tourfold.com/tenant-reset/owner-email-unavailableE-Mail-Adresse des Eigentümers nicht verfügbarFür den Workspace-Eigentümer ist keine E-Mail-Adresse hinterlegt, an die der Bestätigungscode gesendet werden kann422
https://problems.tourfold.com/tenant-reset/reset-failedZurücksetzen fehlgeschlagenDer Workspace konnte nicht zurückgesetzt werden. Ihr Bestätigungscode ist weiterhin gültig — bitte versuchen Sie es erneut500

Tenant-Template-Fehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/tenant-templates/template-not-foundTemplate nicht gefundenDas angeforderte Tenant-Template existiert nicht404
https://problems.tourfold.com/tenant-templates/tenant-not-frozenTenant ist kein eingefrorenes TemplateDie tenant_id_to_clone muss auf einen eingefrorenen Tenant verweisen (Name beginnt mit template_)422

Tour-Fehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/tours/tour-endedTour beendetDie Tour ist bereits beendet422
https://problems.tourfold.com/tours/no-user-associatedKein Benutzer zugeordnetDieser Tour ist kein Benutzer zugeordnet422
https://problems.tourfold.com/tours/start-time-after-endStartzeit liegt nach EndzeitDie Startzeit muss vor dem geplanten Ende liegen422
https://problems.tourfold.com/tours/tour-has-unfinished-activitiesTour hat offene ActivitiesEine Tour mit Activities im Status PENDING oder STARTED kann nicht abgeschlossen werden409
https://problems.tourfold.com/tours/tour-template-in-useTourenvorlage wird verwendetEin 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-configurationTourenvorlage muss konfiguriert werdenDie Vorlage vor dem Erstellen einer Tour reparieren; data.tour_template_id bezeichnet die Vorlage mit fehlenden erforderlichen Eingaben.409

Generische Aufgaben-Touren​

Typ-URITitelAbhilfeHTTP-Status
https://problems.tourfold.com/tours/default-template-protectedStandard-Tourenvorlage ist geschütztDie 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-conflictFahrzeugnutzung der Tour hat sich geändertDas 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-activeGerät kollidiert mit aktiver Tour-ArbeitEine 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-unconfirmedModus der Gerätezuordnung ist unbestätigtEine 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-forbiddenTour-Ausführung nicht erlaubtAls aktiver menschlicher Teilnehmer beitreten; data.reason ist not_member.403
https://problems.tourfold.com/tours/human-requiredAktiver menschlicher Benutzer erforderlichEin aktives menschliches Konto verwenden; zusätzliche Berechtigungen lösen diese Einschränkung nicht.403
https://problems.tourfold.com/tours/not-publishedTour nicht veröffentlichtVor der Ausführung veröffentlichen.409
https://problems.tourfold.com/tours/not-startedTour nicht gestartetVor dem Abschließen starten.409
https://problems.tourfold.com/tours/finishedTour abgeschlossenDie Tour und ihre zugewiesenen Aufgaben können nicht mehr geändert werden.409
https://problems.tourfold.com/tours/already-startedTour bereits gestartetLöschen sowie Änderungen an Teilnehmern und geplantem Beginn sind nicht mehr erlaubt.409
https://problems.tourfold.com/tours/unfinished-workTour hat offene ArbeitAufgaben und eigenständige Stopps vor dem Abschließen erledigen oder entfernen.409
https://problems.tourfold.com/tours/vehicle-activeFahrzeug ist in VerwendungDie aktive Nutzung des Fahrzeugs auflösen, bevor diese Tour gestartet oder geändert wird.409
https://problems.tourfold.com/tours/vehicle-requiredFahrzeug erforderlichDer 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-ineligibleFahrzeug nicht geeignetEine 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-requiredGeplante Fahrzeugzuweisung bestätigenUm 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-activeTeilnehmer bereits aktivDie durch data.tour_id bezeichnete Tour abschließen oder einen anderen Teilnehmer wählen.409
https://problems.tourfold.com/tours/participants-requiredTeilnehmer erforderlichVor der Veröffentlichung Teilnehmer auswählen.409
https://problems.tourfold.com/tours/capacity-exceededTour-Kapazität überschrittenHöchstens 500 Stopps und insgesamt 10000 Aufgaben und Stopps; Umfang reduzieren oder andere Tour wählen.409
https://problems.tourfold.com/tours/task-already-assignedAufgabe bereits zugewiesenDie bestehende Zuweisung verschieben oder entfernen.409
https://problems.tourfold.com/tours/membership-changedZusammensetzung geändertErneut lesen und die vollständige aktuelle Reihenfolge senden.409
https://problems.tourfold.com/tours/stop-has-tasksStopp hat zugewiesene AufgabenVor dem Löschen des Stopps seine Aufgabenzuweisungen entfernen.409
https://problems.tourfold.com/tours/task-backed-stopAufgaben bestimmen den StoppstatusDie zugewiesenen Aufgaben abschließen, statt den Stoppstatus direkt zu setzen.409
https://problems.tourfold.com/tours/same-stopUnterschiedliche Stopps erforderlichVerschiedene IDs für Quell- und Zielstopp wählen.409

Rollenfehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/roles/system-role-immutableSystemrolle ist unveränderlichSystemrollen können weder geändert noch gelöscht werden.409
https://problems.tourfold.com/roles/grant-assignment-deniedGrant-Zuweisung nicht erlaubtGrants, 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 erlaubtDas Ä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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/users/already-assignedBenutzer bereits zugewiesenBenutzer ist bereits zugewiesen422
https://problems.tourfold.com/users/cannot-delete-selfSich selbst löschen nicht erlaubtBenutzer 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-selfSich selbst aktivieren nicht erlaubtBenutzer dürfen sich nicht selbst aktivieren. Enthält data.reason: self_target und data.user_id.403
https://problems.tourfold.com/users/cannot-deactivate-selfSich selbst deaktivieren nicht erlaubtBenutzer dürfen sich nicht selbst deaktivieren. Enthält data.reason: self_target und data.user_id.403
https://problems.tourfold.com/users/owner-deletion-conflictKonflikt 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-ownerNicht der Workspace-EigentümerNur 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-rolesEigene Rollen können nicht geändert werdenDas Ändern der eigenen Rollenzuweisungen ist verboten; data.reason ist self_target.403
https://problems.tourfold.com/users/role-assignment-deniedRollenzuweisung nicht erlaubtDer Aufrufer darf diese Rolle nicht zuweisen; data.reason ist not_member.403
https://problems.tourfold.com/users/owner-role-change-conflictKonflikt beim Ändern der EigentümerrolleVerwenden 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-managedProfil wird von der Person verwaltetDie 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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/vehicles/no-active-device-associationKeine aktive GerätezuordnungKeine aktive Fahrzeug-Geräte-Zuordnung gefunden422
https://problems.tourfold.com/vehicles/no-device-associationKeine GerätezuordnungKeine Fahrzeug-Geräte-Zuordnung gefunden422
https://problems.tourfold.com/vehicles/vehicle-already-assignedFahrzeug bereits zugewiesenFahrzeug ist bereits zugewiesen422
https://problems.tourfold.com/vehicles/vehicle-has-active-tourFahrzeug hat aktive TourFahrzeug hat aktuell eine aktive Tour422
https://problems.tourfold.com/vehicles/vehicle-not-associatedFahrzeug nicht zugeordnetFahrzeug ist nicht zugeordnet422

Fehler bei Fahrzeug-Anbieterverbindungen​

Typ-URITitelAbhilfeHTTP-Status
https://problems.tourfold.com/vehicle-provider-connections/account-disabledAnbieterkonto ist deaktiviertAktivieren Sie das Anbieterkonto, bevor Sie den Anbieter darüber anfragen.409
https://problems.tourfold.com/vehicle-provider-connections/authorization-already-requestedAutorisierung bereits angefragtDie 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-endedAnbieterverbindung 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-progressAnbietervorgang läuftWarten 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-reusedRequest-ID wiederverwendetDie 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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/not-foundNicht gefundenObjekt, Datensatz, Attribut, Option, Status oder Beziehung wurde nicht gefunden404
https://problems.tourfold.com/invalid-inputUngültige EingabeDer Request-Body konnte nicht geparst werden (z. B. fehlerhaftes oder nicht interpretierbares JSON)400
https://problems.tourfold.com/validation-failedValidierung fehlgeschlagenValidierung von Objekt, Attribut, Datensatz, Abfrage oder Berechtigung fehlgeschlagen422
https://problems.tourfold.com/resource-conflictRessourcenkonfliktDie übermittelte lock_version ist veraltet409
https://problems.tourfold.com/objects/relationship-target-in-useRelationsziel wird verwendetAndere Objekte besitzen Relationsattribute mit diesem Ziel; data.blocking_relationships nennt sie409
https://problems.tourfold.com/objects/object-definition-in-useObjektdefinition wird verwendetEin 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-useObjektattribut wird verwendetEin 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-useZähleinheit wird verwendetKapazitä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-largePayload zu großRequest-Payload überschreitet die maximal erlaubte Größe413
https://problems.tourfold.com/records/query-timeoutZeitüberschreitung bei DatensatzabfrageEine strukturierte REST-Datensatzabfrage hat ihre Ausführungsfrist überschritten; data.timeout_ms enthält die konfigurierte Grenze503
https://problems.tourfold.com/unknown-errorUnbekannter FehlerEin 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:

FehlertypBeschreibung und Pointer
field-requiredEine Pflichteingabe fehlt; zeigt auf dieses Feld, zum Beispiel #/attributes/0/config/target.
unknown-fieldEin unbekanntes Config-Feld wurde gesendet; zeigt auf das exakte Feld. Ausgemusterte Beziehungsfelder wie allowed_objects werden so abgelehnt.
inapplicable-fieldEin bekanntes Config-Feld gilt nicht für den gewählten Attributtyp.
invalid-enum-valueEine enumartige Eingabe wie unit_kind hat einen nicht unterstützten Wert.
invalid-slug / slug-already-exists / slug-reserved / duplicate-attribute-slugDer Objekt- oder Attribut-Slug ist ungültig, doppelt oder reserviert.
attribute-type-required / attribute-type-invalidAttribut-type fehlt oder wird nicht unterstützt.
attribute-config-missingDer gewählte Typ benötigt config.
unique-unsupported-type / unique-immutableEindeutigkeit wird für diesen Typ nicht unterstützt oder kann nach dem Anlegen nicht geändert werden.
index-unsupported-typeDer Attributtyp kann keinen Index tragen; raw_json-Dokumente werden nie indexiert.
display-template-unknown-attributedisplay_template verweist auf ein nicht vorhandenes Attribut.
unsupported-display-template-attributedisplay_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-itemsEin 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-linkEin 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-deepEin rich_text-Wert oder -Standardwert überschreitet die kanonische Größen- oder Verschachtelungsgrenze.
full-name-component-requiredEin full_name-Wert enthält einen title ohne first_name oder last_name.
links-unsafe-linkEine links-URL verwendet ein anderes Schema als http, https, mailto oder tel; der Pointer benennt die url des Links.
links-primary-requiredEin links-Wert hat Alternativen, aber keinen primary-Link.
invalid-iconicon ist kein Icon-Schlüssel: Verwenden Sie bis zu 64 Kleinbuchstaben, Ziffern und einzelne Bindestriche. Zeigt auf #/icon.
invalid-pattern / unacceptable-patternEin Textmuster ist ungültig oder verwendet nicht unterstützte Features ohne lineare Laufzeit.
relationship-target-not-foundDas singuläre config.target kann nicht zu einem Objekt aufgelöst werden.
relationship-reverse-slug-conflictreverse.slug wird bereits von einem eigenen Attribut oder einer Beziehung des Zielobjekts verwendet; der Fehler zeigt auf den kollidierenden Rückseiten-Slug.
relationship-reverse-unsupportedDas Relationsziel akzeptiert kein verwaltetes Rückseitenattribut, etwa das System-Objekt user; zeigt auf config.reverse.
relationship-reverse-managedEine verwaltete B-Rückseite wurde gesendet, aktualisiert oder gelöscht. Die Fehlerdaten nennen owner_object und owner_attribute.
system-property-updated / system-property-deletedEin 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​

FehlertypBeschreibung
required-relationEin erforderlicher Beziehungswert fehlt.
cardinality-violation-sourceDie Kardinalität der Quellseite würde überschritten.
cardinality-violation-targetDie Kardinalität der Zielseite würde überschritten.
object-not-foundEine Datensatz-ID existiert nicht im konfigurierten target-Objekt.
invalid-reference-valueEine 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-URIBeschreibung
https://problems.tourfold.com/relation/unknown-field-in-order-byorder_by nennt ein Feld, das im gewählten Objekt nicht vorhanden ist.
https://problems.tourfold.com/relation/invalid-sort-directionDie 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:

FehlertypPointer
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.

FehlertypBeschreibung
type-mismatchWert entspricht nicht dem erwarteten Typ
required-fieldEin Pflichtfeld fehlt
invalid-enum-valueWert ist keiner der erlaubten Enum-Werte
invalid-const-valueWert entspricht nicht der erwarteten Konstante
string-too-shortString-Länge unterschreitet das Minimum
string-too-longString-Länge überschreitet das Maximum
pattern-mismatchString entspricht nicht dem geforderten Pattern
value-too-smallNumerischer Wert unterschreitet das Minimum
value-too-largeNumerischer Wert überschreitet das Maximum
not-multiple-ofNumerischer Wert ist kein Vielfaches des geforderten Wertes
too-few-itemsArray enthält weniger Einträge als erlaubt
too-many-itemsArray enthält mehr Einträge als erlaubt
duplicate-itemsArray enthält doppelte Einträge, obwohl Eindeutigkeit gefordert ist
invalid-formatWert entspricht nicht dem geforderten Format
too-few-propertiesObjekt hat weniger Eigenschaften als gefordert
too-many-propertiesObjekt hat mehr Eigenschaften als erlaubt
additional-properties-not-allowedObjekt enthält Eigenschaften, die im Schema nicht definiert sind
oneOf-mismatchWert entspricht nicht genau einem der oneOf-Schemas
anyOf-mismatchWert entspricht keinem der anyOf-Schemas
allOf-mismatchWert entspricht nicht allen allOf-Schemas
not-mismatchWert entspricht einem Schema, dem er nicht entsprechen soll
conditional-mismatchWert erfüllt nicht ein bedingtes Schema (if/then/else)
dependent-requiredEine abhängige Pflichteigenschaft fehlt
dependent-schema-mismatchWert entspricht nicht einem abhängigen Schema
validation-errorGenerischer Validierungsfehler (Fallback)
instance-payload-too-largedata-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-MusterBedeutung
Validation error (FieldUndefined@...) ... Field ... is undefinedDas Feld existiert im generierten Schema Ihres Workspace nicht. Prüfen Sie den Schema-Endpoint.
Validation error (WrongType@...) ... not a valid SortDirectionEine 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änkungLimitBeschreibung
Query-Länge10.000 ZeichenMaximale Länge des GraphQL-Query-Strings
Query-Kosten100.000 geschätzte DatensätzeMaximale 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-Tiefe12 EbenenMaximale 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ührungszeit10 Sekunden GesamtzeitMaximale Laufzeit einer Operation. Bei Überschreitung: graphql/query-timeout; kooperative Arbeit wird unterbrochen.
Seitengröße (first/last)100Größere Werte liefern graphql/invalid-pagination mit dem übergebenen Wert und maximum.
Standard-Seitengröße20 (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-Verschachtelungstiefe4Maximale where-Rekursionstiefe (_and / _or). Unabhängig von der Query-Tiefe.
Relationsverschachtelung in order_by1 To-one-SprungTiefere 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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/billing/billing-customer-missingBilling-Kunde fehltFür den Tenant gibt es noch keinen Stripe-Kunden; diese Abrechnungsaktion ist daher nicht verfügbar422
https://problems.tourfold.com/billing/plan-change-in-progressTarifwechsel läuftFür diesen Tenant läuft bereits ein Tarifwechsel409
https://problems.tourfold.com/billing/plan-change-not-allowedTarifwechsel nicht erlaubtIm aktuellen Abrechnungszustand kann der Tarif nicht gewechselt werden422
https://problems.tourfold.com/billing/seat-cap-exceededPlatzlimit erreichtDer Tenant hat die im aktuellen Tarif erlaubte Höchstzahl bezahlter Plätze erreicht422
https://problems.tourfold.com/billing/stripe-billing-unavailableStripe-Billing nicht verfügbarStripe-Billing war nicht erreichbar oder konnte die Anfrage nicht verarbeiten503
https://problems.tourfold.com/billing/plan-configuration-invalidTarifkonfiguration ungültigDie Stripe-Konfiguration des Tarifs ist unvollständig oder inkonsistent und kann nicht materialisiert werden (ein serverseitiger/Konfigurationszustand, kein Client-Fehler).500

Signup-Fehler​

Typ-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/signup/email-not-verifiedE-Mail nicht verifiziertVerifizieren Sie Ihre E-Mail, bevor Sie den Signup fortsetzen409
https://problems.tourfold.com/signup/invalid-verification-codeUngültiger VerifizierungscodeDer Verifizierungscode ist nicht gültig, oder es gibt keinen Signup für die E-Mail-Adresse; beides wird gleich beantwortet422
https://problems.tourfold.com/signup/verification-code-expiredVerifizierungscode abgelaufenDer Verifizierungscode ist abgelaufen oder durch fünf falsche Versuche verbraucht; fordern Sie einen neuen an422
https://problems.tourfold.com/signup/subdomain-not-availableSubdomain nicht verfügbarDie gewünschte Subdomain ist bereits vergeben409
https://problems.tourfold.com/signup/subdomain-reservedSubdomain reserviertDie gewünschte Subdomain ist reserviert und kann nicht verwendet werden409
https://problems.tourfold.com/signup/subdomain-invalid-formatUngültiges Subdomain-FormatSubdomain muss 3–16 alphanumerische Kleinbuchstaben verwenden422
https://problems.tourfold.com/signup/session-not-foundSession nicht gefundenDie Signup-Session existiert nicht404
https://problems.tourfold.com/signup/session-already-completedSession bereits abgeschlossenDie Signup-Session wurde bereits abgeschlossen409
https://problems.tourfold.com/signup/session-not-readySession nicht bereitAlle erforderlichen Schritte müssen vor Abschluss des Signups erledigt sein422
https://problems.tourfold.com/signup/payment-pendingZahlung ausstehendDie Zahlung wird noch verarbeitet. Bitte warten und erneut versuchen409
https://problems.tourfold.com/signup/completion-in-progressSignup-Abschluss läuftDer Signup wird gerade abgeschlossen. Bitte warten und erneut versuchen409
https://problems.tourfold.com/signup/payment-not-completedZahlung nicht abgeschlossenDie Zahlung wurde nicht abgeschlossen409
https://problems.tourfold.com/signup/payment-failedZahlung fehlgeschlagenDie Zahlung ist fehlgeschlagen. Bitte einen Tarif wählen und erneut versuchen409
https://problems.tourfold.com/signup/email-rate-limitedE-Mail-Rate begrenztZu viele Verifizierungsanfragen in kurzer Zeit429
https://problems.tourfold.com/signup/invalid-invite-codeUngültiger EinladungscodeDer angegebene Einladungscode ist nicht gültig422
https://problems.tourfold.com/signup/email-sending-failedE-Mail-Versand fehlgeschlagenDie Verifizierungs-E-Mail konnte nicht gesendet werden503
https://problems.tourfold.com/signup/tenant-creation-failedTenant-Erstellung fehlgeschlagenDie Plattform konnte für diesen Signup keinen Tenant erstellen500
https://problems.tourfold.com/signup/account-link-requiredKontoverknüpfung erforderlichZur 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-rejectedKontoverknüpfung abgelehntDas 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-incompleteKontoprofil unvollständigDas 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-URITitelBeschreibungHTTP-Status
https://problems.tourfold.com/capacity/not-foundMaßeinheit nicht gefundenMaßeinheit wurde nicht gefunden404
https://problems.tourfold.com/capacity/measure-unit-in-useMaßeinheit wird verwendetAttribute 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.