Zum Hauptinhalt springen

Ungültiger Betrag

typehttps://docs.frem.sh/reference/api/errors/invalid-amount
HTTP-Status400 Bad Request

Was das bedeutet

Ein Betragsfeld war keine Dezimalzeichenkette.

Beispiele für detail-Meldungen, die mit diesem Fehler zurückkommen:

  • amount_eur must be a decimal string such as “12.50”; omit it to refund the remainder.

Was du tun kannst

Sende den Betrag als Zeichenkette in Haupteinheiten, mit Dezimalpunkt: "12.50", nicht 12.5 und nicht 1250. Eine Zeichenkette ist nötig, weil binäre Gleitkommazahlen die meisten Dezimalbeträge nicht exakt darstellen können, und ein Rundungsfehler in einem Geldfeld ist eine echte Abweichung und kein bloßes Anzeigeproblem.

Um alles zu erstatten, was noch offen ist, lass das Feld ganz weg, statt den Rest selbst zu berechnen – der Server weiß, was bereits erstattet wurde.

Form der Antwort

Alle Fehler der fremforge-API sind RFC 9457 problem+json:

{
  "type": "https://docs.frem.sh/reference/api/errors/invalid-amount",
  "title": "Bad Request",
  "status": 400,
  "detail": "..."
}

Werte type aus, nicht title oder detail – diese sind für Menschen gedacht und können umformuliert werden.