Aller au contenu principal

Préférence invalide

typehttps://docs.frem.sh/reference/api/errors/invalid-preference
Statut HTTP400 Bad Request

Ce que cela signifie

La valeur preference dans le corps de la requête ne fait pas partie des valeurs acceptées.

Ce sont des paramètres de notification natifs de Forgejo : l’ensemble accepté est donc fixe et correspond exactement au vocabulaire de Forgejo :

ValeurEffet
enabledRecevoir tous les e-mails de notification (valeur par défaut de Forgejo).
onmentionRecevoir un e-mail uniquement en cas de mention explicite.
andyourownRecevoir aussi un e-mail pour vos propres actions.
disabledNe recevoir aucun e-mail de notification.

La correspondance respecte la casse : onmention est valide, onMention et ONMENTION ne le sont pas.

Que faire

Envoyez l’une des quatre valeurs ci-dessus, écrite en minuscules.

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

Forme de la réponse

Toutes les erreurs de l’API fremforge sont au format problem+json de la RFC 9457 :

{
  "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."
}

Basez votre logique sur type, et non sur title ou detail : ces champs sont destinés à être lus par un humain et peuvent être reformulés.