Préférence invalide
type | https://docs.frem.sh/reference/api/errors/invalid-preference |
| Statut HTTP | 400 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 :
| Valeur | Effet |
|---|---|
enabled | Recevoir tous les e-mails de notification (valeur par défaut de Forgejo). |
onmention | Recevoir un e-mail uniquement en cas de mention explicite. |
andyourown | Recevoir aussi un e-mail pour vos propres actions. |
disabled | Ne 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-mailForme 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.