Hoppa till huvudinnehållet

Ingen principal

typehttps://docs.frem.sh/reference/api/errors/no-principal
HTTP status403 Forbidden

Vad det betyder

Begäran autentiserades, men den anropande användaren kunde inte kopplas till ett Forgejo-konto, så det finns ingen identitet att kontrollera ägarskap mot.

API:t avvisar här i stället för att gissa en ägare. En resurs som tillskrivs fel användar-id är en resurs som dess verkliga ägare inte kan se, och det är ett sämre utfall än ett tydligt avslag.

Exempel på detail-meddelanden som returneras med det här felet:

  • Could not resolve the calling user.

Vad du gör

Oftast är det en token vars användare sedan dess har bytt namn eller tagits bort. Kör fremforge auth login igen; om felet kvarstår, mejla support@frem.sh med token-id:t från fremforge auth tokens list, aldrig själva token.

Svarets form

Alla fel från fremforges API är RFC 9457 problem+json:

{
  "type": "https://docs.frem.sh/reference/api/errors/no-principal",
  "title": "Forbidden",
  "status": 403,
  "detail": "..."
}

Styr din felhantering på type, inte på title eller detail: de är skrivna för människor och kan formuleras om.