de

Fehlercodes

Alle Fehlercodes, die die öffentliche API derzeit zurückgibt, generiert aus der OpenAPI-Spezifikation. Eine fehlgeschlagene Antwort enthält den Code im Feld error_code des Envelopes.

FehlercodeHTTP-StatusZurückgegeben von
BUSINESS_LOCATION_MISSING400create-technician, update-technician
IDEMPOTENCY_KEY_INVALID400create-webhook-endpoint
INVALID_REQUEST_BODY400book-and-confirm-job-request, commit-absence-resolve, commit-emergency-reschedule, commit-job-request-move, confirm-job-request, create-customer, create-job-request, create-job-type, create-service-area, create-skill, create-skill-category, create-technician, create-technician-time-off, create-vehicle, create-webhook-endpoint, delete-skill, delete-skill-category, get-job-request, get-job-request-timeline, get-technician-schedule, list-emergency-candidates, list-job-request-booking-windows, list-job-request-changes, list-job-requests, list-job-types, list-service-areas, list-skills-by-category, list-technician-skills, list-technician-time-off, list-technicians, list-vehicles, preview-absence-resolve, preview-emergency-reschedule, preview-job-request-move, quote-job-request, replace-technician-buddies, replace-technician-leads, replace-technician-service-areas, replace-technician-skills, replace-technician-vehicles, update-customer, update-job-priority, update-job-type, update-service-area, update-skill, update-technician, update-vehicle
INVALID_TIMEZONE400create-job-request, list-job-request-booking-windows
JOB_REQUEST_ADDRESS_REQUIRED400book-and-confirm-job-request, create-job-request
JOB_REQUEST_AFTER_HOURS_REQUIRES_TECHNICIAN400confirm-job-request
JOB_REQUEST_INVALID_INPUT400confirm-job-request, create-job-request, get-technician-schedule, list-crew-candidates, list-matching-slots, list-nearby-technicians, quote-job-request, update-job-priority
JOB_TYPE_INVALID_DEFAULT_DURATION400create-job-type, update-job-type
JOB_TYPE_INVALID_NAME400create-job-type, update-job-type
JOB_TYPE_INVALID_STATUS400create-job-type, update-job-type
PHONE_INVALID400book-and-confirm-job-request, create-customer, create-technician, list-customers, update-customer, update-technician
PHONE_OR_EMAIL_REQUIRED400create-customer, update-customer
SERVICE_AREA_INVALID_BOUNDARY400create-service-area, update-service-area
TECHNICIAN_CONTACT_REQUIRED400create-technician, update-technician
TECHNICIAN_INVALID_BUDDY400replace-technician-buddies, replace-technician-leads
TECHNICIAN_INVALID_TIER400create-technician, update-technician
TIME_OFF_END_BEFORE_START400create-technician-time-off
TIME_OFF_INVALID_DATE400create-technician-time-off
TIME_OFF_REASON_TOO_LONG400create-technician-time-off
VALIDATION_ERROR400create-skill, create-skill-category, update-skill
VEHICLE_INVALID_OWNER400create-vehicle, update-vehicle
VEHICLE_OWNER_TIER_NOT_ALLOWED400create-vehicle, update-vehicle
WEBHOOK_INVALID_EVENT400create-webhook-endpoint
WEBHOOK_INVALID_URL400create-webhook-endpoint
WEBHOOK_SECRET_EXPIRY_INVALID400create-webhook-endpoint
WRONG_QUERY400list-customers, list-skill-categories, list-skills-by-category, list-technician-skills
API_KEY_INVALID401book-and-confirm-job-request, commit-absence-resolve, commit-emergency-reschedule, commit-job-request-move, confirm-job-request, create-job-request, create-webhook-endpoint, delete-webhook-endpoint, get-job-request, get-technician-schedule, list-crew-candidates, list-emergency-candidates, list-job-request-booking-windows, list-job-request-changes, list-job-requests, list-matching-slots, list-nearby-technicians, list-technician-time-off, list-webhook-event-types, preview-absence-resolve, preview-emergency-reschedule, preview-job-request-move, quote-job-request, update-job-priority
UNAUTHORIZED401book-and-confirm-job-request, commit-absence-resolve, commit-emergency-reschedule, commit-job-request-move, confirm-job-request, create-customer, create-job-request, create-job-type, create-service-area, create-skill, create-skill-category, create-technician, create-technician-time-off, create-vehicle, create-webhook-endpoint, delete-customer, delete-job-type, delete-service-area, delete-skill, delete-skill-category, delete-technician, delete-vehicle, delete-webhook-endpoint, get-customer, get-job-request, get-job-request-timeline, get-job-type, get-service-area, get-technician, get-technician-schedule, get-vehicle, list-assignable-groups, list-crew-candidates, list-customers, list-emergency-candidates, list-job-request-booking-windows, list-job-request-changes, list-job-requests, list-job-types, list-matching-slots, list-nearby-technicians, list-service-areas, list-skill-categories, list-skills, list-skills-by-category, list-technician-skills, list-technician-time-off, list-technicians, list-vehicles, list-webhook-event-types, preview-absence-resolve, preview-emergency-reschedule, preview-job-request-move, quote-job-request, replace-technician-buddies, replace-technician-leads, replace-technician-service-areas, replace-technician-skills, replace-technician-vehicles, update-customer, update-job-priority, update-job-type, update-service-area, update-skill, update-technician, update-vehicle
FORBIDDEN403list-assignable-groups, update-job-priority
JOB_TYPE_SYSTEM_READ_ONLY403delete-job-type, update-job-type
SANDBOX_MANAGEMENT_ROLE_FORBIDDEN403create-technician, update-technician
TECHNICIAN_GROUP_NOT_ASSIGNABLE403create-technician, update-technician
TECHNICIAN_ROLE_API_KEY_FORBIDDEN403create-technician, update-technician
TECHNICIAN_TARGET_NOT_MANAGEABLE403create-technician, update-technician
WEBHOOK_EVENT_NOT_PERMITTED403create-webhook-endpoint
BUSINESS_GROUP_NOT_FOUND404create-technician, update-technician
BUSINESS_NOT_FOUND404create-customer, create-service-area
CUSTOMER_NOT_FOUND404book-and-confirm-job-request, create-job-request, delete-customer, get-customer, update-customer
JOB_REQUEST_NOT_FOUND404commit-emergency-reschedule, commit-job-request-move, confirm-job-request, get-job-request, get-job-request-timeline, list-crew-candidates, list-emergency-candidates, list-matching-slots, preview-emergency-reschedule, preview-job-request-move, quote-job-request, update-job-priority
JOB_TYPE_NOT_FOUND404book-and-confirm-job-request, create-job-request, delete-job-type, get-job-type, update-job-type
SERVICE_AREA_NOT_FOUND404create-technician, delete-service-area, get-service-area, update-service-area
SKILL_CATEGORY_NOT_FOUND404create-skill, delete-skill-category, list-skills-by-category
SKILL_NOT_FOUND404book-and-confirm-job-request, create-job-request, delete-skill, replace-technician-skills, update-skill
TECHNICIAN_NOT_FOUND404commit-absence-resolve, create-technician, create-technician-time-off, delete-technician, get-technician, get-technician-schedule, list-technician-skills, preview-absence-resolve, replace-technician-buddies, replace-technician-service-areas, replace-technician-skills, replace-technician-vehicles, update-technician
VEHICLE_NOT_FOUND404delete-vehicle, get-vehicle, replace-technician-vehicles, update-vehicle
WEBHOOK_NOT_FOUND404delete-webhook-endpoint
ABSENCE_RESOLVE_NO_ORPHANED_JOBS409commit-absence-resolve
CUSTOMER_DUPLICATE_EMAIL409create-customer, update-customer
CUSTOMER_DUPLICATE_LOCATION_ADDRESS409update-customer
CUSTOMER_DUPLICATE_PHONE409create-customer, update-customer
CUSTOMER_DUPLICATE_UID409create-customer, update-customer
EMERGENCY_RESCHEDULE_IN_PAST409commit-emergency-reschedule, preview-emergency-reschedule
IDEMPOTENCY_IN_PROGRESS409book-and-confirm-job-request, create-job-request, create-webhook-endpoint
JOB_REQUEST_AFTER_HOURS_CREW_UNSUPPORTED409confirm-job-request
JOB_REQUEST_AFTER_HOURS_MULTIDAY_UNSUPPORTED409confirm-job-request
JOB_REQUEST_AFTER_HOURS_REQUIRES_P0409confirm-job-request
JOB_REQUEST_INVALID_TRANSITION409list-crew-candidates
JOB_REQUEST_NO_TECHNICIAN_AVAILABLE409list-crew-candidates
JOB_TYPE_DUPLICATE409create-job-type, update-job-type
SCHEDULE_MOVE_CREW_UNSTAFFABLE409commit-job-request-move, preview-job-request-move
SCHEDULE_MOVE_IN_PAST409commit-job-request-move, preview-job-request-move
SERVICE_AREA_DUPLICATE_NAME409create-service-area, update-service-area
SKILL_CATEGORY_DUPLICATE_NAME409create-skill-category
SKILL_CATEGORY_NOT_EMPTY409delete-skill-category
SKILL_DUPLICATE_NAME409create-skill, update-skill
SKILL_HAS_MEMBERS409delete-skill
SKILL_INACTIVE409create-job-request, replace-technician-skills
TECHNICIAN_ALREADY_MEMBER409create-technician
TECHNICIAN_DUPLICATE_EMAIL409create-technician, update-technician
TECHNICIAN_DUPLICATE_PHONE409create-technician, update-technician
TECHNICIAN_IDENTITY_CONFLICT409create-technician
TECHNICIAN_LAST_OWNER409delete-technician
TIME_OFF_OVERLAP409create-technician-time-off
VEHICLE_DUPLICATE_NAME409create-vehicle, update-vehicle
VEHICLE_DUPLICATE_PLATE409create-vehicle, update-vehicle
WEBHOOK_LIMIT_REACHED409create-webhook-endpoint
IDEMPOTENCY_KEY_REUSE422book-and-confirm-job-request

Ablauf von Zugangsdaten

Zugangsdaten haben begrenzte Laufzeiten; diese Codes unterscheiden einen Ablauf von einem Widerruf oder einem falschen Wert:

FehlercodeHTTP-StatusBedeutung
API_KEY_EXPIRED401Der API-Schlüssel hat seine Laufzeit überschritten — erstellen Sie einen Ersatzschlüssel. Bewusst getrennt von API_KEY_INVALID (widerrufen, gelöscht oder falsch).
OAUTH_GRANT_EXPIRED401Die OAuth-Verbindung ist erloschen (30-Tage-Inaktivitätsfenster oder absolute Obergrenze) — der Inhaber muss die App erneut über den Consent-Screen genehmigen.
API_KEY_SCOPE_NOT_GRANTED403Der neue Schlüssel hat Scopes angefordert, die über die seines Erstellers hinausgehen — siehe Authentifizierung.
WEBHOOK_SECRET_EXPIRED409Verify wurde für einen Endpunkt aufgerufen, dessen Signatur-Secret abgelaufen ist — rotieren Sie zuerst das Secret, dann verifizieren Sie.
API_KEY_EXPIRY_INVALID400Die angeforderte Schlüssel-Laufzeit liegt außerhalb von 1–365 Tagen.
WEBHOOK_SECRET_EXPIRY_INVALID400Die angeforderte Laufzeit des Webhook-Signatur-Secrets liegt außerhalb von 1–365 Tagen.
OAUTH_GRANT_LIFETIME_INVALID400Die angeforderte Obergrenze der MCP-Verbindungslaufzeit liegt außerhalb von 1–365 Tagen.

Notfall-Disposition

Die Endpunkte der Notfall-Disposition führen eigene Codes ein:

FehlercodeHTTP-StatusBedeutung
EMERGENCY_RESCHEDULE_INVALID_INPUT400Der Request-Body der Notfall-Preview hat die Validierung nicht bestanden.