Aucun principal

Ce que cela signifie

La requête s’est authentifiée, mais l’utilisateur appelant n’a pas pu être associé à un compte Forgejo : il n’y a donc aucune identité par rapport à laquelle vérifier la propriété.

L’API refuse ici plutôt que de deviner un propriétaire. Une ressource attribuée au mauvais identifiant d’utilisateur est une ressource que son véritable propriétaire ne peut pas voir, ce qui est pire qu’un refus clair.

Exemples de messages detail renvoyés avec cette erreur :

• Could not resolve the calling user.

Que faire

C’est généralement un jeton dont l’utilisateur a depuis été renommé ou supprimé. Relancez fremforge auth login ; si le problème persiste, écrivez à support@frem.sh en indiquant l’identifiant du jeton donné par fremforge auth tokens list, jamais le jeton lui-même.

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/no-principal",
  "title": "Forbidden",
  "status": 403,
  "detail": "..."
}

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.