Gå til hovedindhold

Ugyldig præference

typehttps://docs.frem.sh/reference/api/errors/invalid-preference
HTTP status400 Bad Request

Hvad det betyder

Værdien af preference i forespørgslens body er ikke en af de accepterede værdier.

Det er Forgejos egne indstillinger for notifikationer, så de accepterede værdier ligger fast og svarer præcist til Forgejos egne begreber:

VærdiVirkning
enabledModtag alle notifikationsmails (Forgejos standard).
onmentionModtag kun mail, når du bliver nævnt direkte.
andyourownModtag også mail om dine egne handlinger.
disabledModtag ingen notifikationsmails.

Der skelnes mellem store og små bogstaver: onmention er gyldig, onMention og ONMENTION er ikke.

Hvad du skal gøre

Send en af de fire værdier ovenfor, stavet med små bogstaver.

curl -X PATCH \
  -H "Authorization: Bearer $FREMFORGE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"preference":"onmention"}' \
  https://frem.sh/_app/api/v1/orgs/<org>/members/<login>/forgejo-mail

Svarets form

Alle fejl fra fremforges API er RFC 9457 problem+json:

{
  "type": "https://docs.frem.sh/reference/api/errors/invalid-preference",
  "title": "Bad Request",
  "status": 400,
  "detail": "preference must be one of: enabled, onmention, andyourown, disabled."
}

Lad din kode træffe beslutninger ud fra type, ikke ud fra title eller detail – de er skrevet til mennesker og kan blive omformuleret.