Termin aktualisieren

{
  "operationId": "put_v2_date",
  "summary": "Termin aktualisieren",
  "description": "Ändert die übergebenen schreibbaren Felder in data für Termin. Die Ziel-ID muss als id im JSON-Umschlag angegeben werden. Nach erfolgreicher Änderung werden zusammengefasste Angebotsdaten (erster/letzter Termin und Ort) neu berechnet; data.offer kann die dabei ermittelten Angebotsdaten enthalten.",
  "tags": [
    "date"
  ],
  "security": [
    {
      "bearerAuth": [],
      "accountContext": []
    },
    {
      "sessionCookie": [],
      "accountContext": []
    }
  ],
  "parameters": [
    {
      "name": "language",
      "in": "header",
      "required": false,
      "description": "Account language code, where the resource supports setLanguage().",
      "schema": {
        "type": "string",
        "examples": [
          "de"
        ]
      }
    },
    {
      "name": "X-Edoobox-If-Revision",
      "in": "header",
      "required": false,
      "schema": {
        "type": "string",
        "pattern": "^[a-f0-9]{32}$",
        "examples": [
          "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
        ]
      },
      "description": "Optional account mutation revision from a preceding authenticated auth-context snapshot. The dispatcher compares it while holding the account lock; mismatch409 requires a new review."
    }
  ],
  "responses": {
    "200": {
      "description": "Ergebnis in data mit den beschriebenen Feldern; error und die Ergebniskennzeichen müssen ausgewertet werden.",
      "content": {
        "application/json": {
          "example": {
            "success": true,
            "error": false,
            "data": {
              "id": "date_012345abcdef_123456",
              "update": true
            }
          },
          "schema": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "error": {
                "type": [
                  "boolean",
                  "string"
                ]
              },
              "error_code": {
                "type": "string"
              },
              "data": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "pattern": "^date_[a-f0-9]{12}_-?[0-9]+$",
                    "description": "Öffentliche v2-ID im gewählten Konto; Beispiel ist synthetisch.",
                    "examples": [
                      "date_012345abcdef_123456"
                    ]
                  },
                  "update": {
                    "type": "boolean"
                  },
                  "offer": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "pattern": "^offer_[a-f0-9]{12}_-?[0-9]+$",
                        "description": "Öffentliche v2-ID im gewählten Konto; Beispiel ist synthetisch.",
                        "examples": [
                          "offer_012345abcdef_123456"
                        ]
                      },
                      "date_start": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "const": false
                          }
                        ]
                      },
                      "date_end": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "const": false
                          }
                        ]
                      }
                    },
                    "additionalProperties": true
                  }
                },
                "additionalProperties": true,
                "required": [
                  "id",
                  "update"
                ]
              },
              "type": {
                "type": "string"
              }
            },
            "additionalProperties": true
          }
        }
      },
      "headers": {
        "X-Edoobox-Revision": {
          "schema": {
            "type": "string",
            "pattern": "^[a-f0-9]{32}$"
          },
          "description": "Rotated account revision supplied for the next action in one reviewed sequence."
        }
      }
    },
    "400": {
      "description": "Invalid request.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED40006"
          }
        }
      }
    },
    "401": {
      "description": "Missing/expired token, missing account context, account paused or model-specific authorization failure.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED40103"
          }
        }
      }
    },
    "402": {
      "description": "Missing/invalid action data or subscription/operation restriction.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED80100"
          }
        }
      }
    },
    "403": {
      "description": "Permission denied. Browser CORS rejection may have an empty body.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED40340"
          }
        }
      }
    },
    "404": {
      "description": "Unknown resource/action or unsupported method.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED80019"
          }
        }
      }
    },
    "409": {
      "description": "The account changed after the reviewed read. No domain operation is dispatched; obtain fresh state and review again.",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "additionalProperties": true
          },
          "example": {
            "error": "ED40901",
            "error_code": "mutation_revision_conflict"
          }
        }
      }
    },
    "422": {
      "description": "Validation failed.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED80020"
          }
        }
      }
    },
    "429": {
      "description": "Request/login rate limit exceeded. Honor Retry-After when supplied; legacy rate-limit paths may omit it. Retry only proven reads within a bounded deadline; a mutation is never automatically replayed after an ambiguous response.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED42902"
          }
        }
      },
      "headers": {
        "Retry-After": {
          "description": "Optional server delay in whole seconds or an HTTP date. Absence is not permission for an immediate retry.",
          "schema": {
            "type": "string",
            "examples": [
              "30"
            ]
          }
        }
      }
    },
    "502": {
      "description": "Server-side operation failed.",
      "content": {
        "application/json": {
          "example": {
            "success": false,
            "error": "ED50201"
          }
        }
      }
    },
    "503": {
      "description": "The account mutation lock or revision store is unavailable. No unprotected fallback is executed.",
      "headers": {
        "Retry-After": {
          "schema": {
            "type": "integer",
            "const": 1
          }
        }
      },
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "additionalProperties": true
          },
          "example": {
            "error": "ED50301",
            "error_code": "mutation_revision_busy"
          }
        }
      }
    }
  },
  "x-edoobox-mutates-state": true,
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "properties": {
            "data": {
              "type": "object",
              "properties": {
                "id": false,
                "description": {
                  "x-edoobox-canonicalType": "string",
                  "x-edoobox-maxStoredLength": 250,
                  "x-edoobox-normalization": "The aP getter trims text, replaces newlines and limits the legacy escaped storage representation to maxStoredLength UTF-8 characters without splitting escape pairs; aQ decodes the stored representation. Non-string input becomes empty text. This getter limit is normalization, not a rejecting input maxLength or proof of a custom action hook or database column capacity.",
                  "examples": [
                    "Example"
                  ],
                  "x-edoobox-sourceLine": 40
                },
                "date_start": {
                  "x-edoobox-canonicalType": "string",
                  "description": "dP uses PHP strtotime(); unparseable/falsy results normalize to zero. ISO 8601 text is the canonical client input; no rejecting JSON date-time format assertion is established here. Account/action hooks may add preconditions.",
                  "examples": [
                    "2026-10-15T10:00:00+02:00"
                  ],
                  "x-edoobox-requiredOnCreate": true,
                  "x-edoobox-sourceLine": 49
                },
                "date_end": {
                  "x-edoobox-canonicalType": "string",
                  "description": "dP uses PHP strtotime(); unparseable/falsy results normalize to zero. ISO 8601 text is the canonical client input; no rejecting JSON date-time format assertion is established here. Account/action hooks may add preconditions.",
                  "examples": [
                    "2026-10-15T10:00:00+02:00"
                  ],
                  "x-edoobox-requiredOnCreate": true,
                  "x-edoobox-sourceLine": 62
                },
                "place": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^[a-z0-9]+_[a-f0-9]{12}_-?[0-9]+$",
                      "description": "Opaque v2 ID returned for a record in the selected account."
                    },
                    {
                      "const": false
                    },
                    {
                      "type": "null"
                    },
                    {
                      "const": ""
                    },
                    {
                      "const": 0
                    },
                    {
                      "const": "0"
                    }
                  ],
                  "description": "A falsey value clears the relation; a nonempty public v2 ID selects the relation.",
                  "x-edoobox-contractSource": [
                    {
                      "file": "application/models/v2/Date.php",
                      "line": 77,
                      "reason": "Falsey write input becomes zero; otherwise the public relation ID is decoded.",
                      "sha256": "6c2cc9b158ba60e211d7da77a920adc45001382fdb859ff62c711562d493b264"
                    },
                    {
                      "file": "application/models/v2/Date.php",
                      "line": 84,
                      "reason": "Response is a public relation ID or false.",
                      "sha256": "6c2cc9b158ba60e211d7da77a920adc45001382fdb859ff62c711562d493b264"
                    }
                  ]
                },
                "room": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^[a-z0-9]+_[a-f0-9]{12}_-?[0-9]+$",
                      "description": "Opaque v2 ID returned for a record in the selected account."
                    },
                    {
                      "const": false
                    },
                    {
                      "type": "null"
                    },
                    {
                      "const": ""
                    },
                    {
                      "const": 0
                    },
                    {
                      "const": "0"
                    }
                  ],
                  "description": "A falsey value clears the relation; a nonempty public v2 ID selects the relation.",
                  "x-edoobox-contractSource": [
                    {
                      "file": "application/models/v2/Date.php",
                      "line": 90,
                      "reason": "Falsey write input becomes zero; otherwise the public relation ID is decoded.",
                      "sha256": "6c2cc9b158ba60e211d7da77a920adc45001382fdb859ff62c711562d493b264"
                    },
                    {
                      "file": "application/models/v2/Date.php",
                      "line": 97,
                      "reason": "Response is a public relation ID or false.",
                      "sha256": "6c2cc9b158ba60e211d7da77a920adc45001382fdb859ff62c711562d493b264"
                    }
                  ]
                },
                "offer": false,
                "leader": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "pattern": "^admin_[a-f0-9]{12}_-?[0-9]+$",
                    "description": "Public admin v2 ID returned for a currently existing record in the selected account; signature, resource type and account ownership are checked by the native hook."
                  },
                  "description": "Assigns administrators as leaders of this date within the current account.\nThe relation hook applies assignments separately from the storage getter.\n\nA JSON list of existing administrators in the selected account. The full deduplicated set is validated before assignment changes; [] removes all leaders. Wrong types, missing or foreign administrators reject the replacement.",
                  "x-edoobox-contractSource": [
                    {
                      "file": "application/models/v2/Datefunc.php",
                      "line": 174,
                      "lineEnd": 179,
                      "reason": "PUT obtains a fully validated leader list before modifying assignments.",
                      "sha256": "66cb9ba28b2fba16b68a1f1d213c72010ba38750e8bdb34deb9d82bbdf630b1a"
                    },
                    {
                      "file": "application/models/v2/Datefunc.php",
                      "line": 239,
                      "lineEnd": 243,
                      "reason": "POST relation callback consumes the same validated list.",
                      "sha256": "66cb9ba28b2fba16b68a1f1d213c72010ba38750e8bdb34deb9d82bbdf630b1a"
                    },
                    {
                      "file": "application/models/v2/Datefunc.php",
                      "line": 266,
                      "lineEnd": 289,
                      "reason": "Strict list, typed admin decoding, positive IDs and deduplicated same-account user_info existence checks precede relation mutations.",
                      "sha256": "66cb9ba28b2fba16b68a1f1d213c72010ba38750e8bdb34deb9d82bbdf630b1a"
                    },
                    {
                      "file": "application/models/v2/Date.php",
                      "line": 131,
                      "reason": "Response maps joined leaders to an array of public administrator IDs.",
                      "sha256": "6c2cc9b158ba60e211d7da77a920adc45001382fdb859ff62c711562d493b264"
                    }
                  ]
                },
                "color": {
                  "description": "Canonical #RGB/#RRGGBB. Also accepts unprefixed 4/7 hex chars; strings of other lengths clear. Length 4/7 nonhex rejects. Not equivalent to strict CSS hex regex. Canonical representations are shown; other PHP scalar coercions are not presented as rejection constraints.\n\nfalse or string length other than 4/7 -> empty aP string. At length4/7, hexadecimal after ltrim(all leading #) is required; nonhex returns false. Empty output -> false.\n\nRuntime preconditions / rejection: Length4/7 nonhex text returns strict false -> ED80100.",
                  "x-edoobox-canonicalType": "string or false",
                  "x-edoobox-schemaStatus": "source-reviewed",
                  "examples": [
                    "#a1b",
                    false
                  ],
                  "x-edoobox-contractSource": [
                    {
                      "file": "application/models/v2/Date.php",
                      "line": 153,
                      "lineStart": 153,
                      "lineEnd": 172,
                      "sha256": "6c2cc9b158ba60e211d7da77a920adc45001382fdb859ff62c711562d493b264",
                      "spanSha256": "2ec5847a45af791e05db717f2e4f5946198cf290fc3c441b95d55d54f6045814",
                      "reason": "Structure getter, output setter and field flags."
                    },
                    {
                      "file": "application/helpers/edooboxhelp_helper.php",
                      "line": 11560,
                      "lineStart": 11560,
                      "lineEnd": 11606,
                      "sha256": "090d351b5bde81813c7a829bedf2f1f9f978fce5765f246989779f996198934e",
                      "spanSha256": "2172cc49e4bcdb6840448b62929037cb9b90c299da3cb6fb0be6a8782881750f",
                      "reason": "aP text normalization and aQ output. Reviewed aP update preserves legacy encoded storage and aQ read semantics. Truncation removes a dangling final escape backslash rather than creating a broken SQL literal; it remains normalization, not a rejecting raw input maxLength."
                    },
                    {
                      "file": "application/models/v2/Date.php",
                      "line": 189,
                      "lineStart": 189,
                      "lineEnd": 202,
                      "sha256": "6c2cc9b158ba60e211d7da77a920adc45001382fdb859ff62c711562d493b264",
                      "spanSha256": "d6306bef7b4617f803aff2ac2de39df94f0233667a11ff2c4b269b9a46d47987",
                      "reason": "Actual resource dispatch and generic writer reachability; action branches are distinct."
                    },
                    {
                      "file": "application/models/v2/Date.php",
                      "line": 237,
                      "lineStart": 237,
                      "lineEnd": 244,
                      "sha256": "6c2cc9b158ba60e211d7da77a920adc45001382fdb859ff62c711562d493b264",
                      "spanSha256": "ccfc31e1b13732e53c6b5ff2f95400c7664e404c4bc10eb0645152b9e3f4bb47",
                      "reason": "Actual resource dispatch and generic writer reachability; action branches are distinct."
                    },
                    {
                      "file": "docs/openapi/reviews/domain-fields.json",
                      "line": 1,
                      "reason": "Independent field-level source review, direction applicability, examples and explicit runtime limitations.",
                      "sha256": "0da1cbbf108a5871b54204c3c76aaf59dabf85a6886bfb38210136885cfc1667"
                    }
                  ]
                }
              },
              "additionalProperties": true,
              "description": "Source-declared fields; action-specific and account validation still apply.",
              "minProperties": 1,
              "x-edoobox-readOnlyFields": [
                "offer"
              ],
              "x-edoobox-clientRestriction": "Read-only fields are forbidden by this client contract to prevent silently ignored writes; the legacy API itself skips them. Explicit source-marked update context fields remain accepted for hook validation without changing their immutable database columns."
            },
            "id": {
              "type": "string",
              "pattern": "^[a-z0-9]+_[a-f0-9]{12}_-?[0-9]+$",
              "description": "Opaque edoobox v2 object ID returned by this account. Never send a raw database ID. The synthetic example is illustrative and is not a real record.",
              "examples": [
                "date_012345abcdef_123456"
              ]
            }
          },
          "additionalProperties": true,
          "required": [
            "data",
            "id"
          ]
        },
        "examples": {
          "request": {
            "summary": "Termin aktualisieren",
            "value": {
              "data": {
                "description": "Example"
              },
              "id": "date_012345abcdef_123456"
            }
          }
        }
      }
    }
  },
  "x-edoobox-runtimeMutationGuard": true,
  "x-edoobox-documentationReview": {
    "file": "docs/openapi/operation-contracts/03-offers-places.json",
    "notes": []
  },
  "x-edoobox-source": {
    "file": "application/models/v2/Date.php",
    "method": "updateDate",
    "line": 237
  },
  "x-edoobox-documentationStatus": "reviewed",
  "x-edoobox-readOnly": false,
  "x-edoobox-safeForAutomation": false,
  "x-edoobox-permission": {
    "resource": "date",
    "short": "date",
    "checkedByDispatcher": true,
    "levels": [
      3,
      4
    ],
    "description": "Resource permission mapping from APIPermissions(), Authfunc::_getCheckJWT. Additional model/admin/plugin checks may apply; resources absent from api_permission do not acquire a fictitious scope."
  }
}