Kein Principal
type | https://docs.frem.sh/reference/api/errors/no-principal |
| HTTP-Status | 403 Forbidden |
Was das bedeutet
Die Anfrage war authentifiziert, aber der aufrufende Nutzer ließ sich keinem Forgejo-Konto zuordnen – es gibt also keine Identität, gegen die die Inhaberschaft geprüft werden könnte.
Die API lehnt hier ab, statt einen Inhaber zu raten. Eine Ressource, die der falschen Nutzer-ID zugeordnet ist, kann ihr wirklicher Inhaber nicht sehen, und das ist schlimmer als eine klare Ablehnung.
Beispiele für detail-Meldungen, die mit diesem Fehler zurückkommen:
- Could not resolve the calling user.
Was du tun kannst
Meist ist es ein Token, dessen Nutzer inzwischen umbenannt oder entfernt wurde. Führe fremforge auth login erneut aus; hält es an, schreib an support@frem.sh und nenne die Token-ID aus fremforge auth tokens list – nie das Token selbst.
Form der Antwort
Alle Fehler der fremforge-API sind RFC 9457 problem+json:
{
"type": "https://docs.frem.sh/reference/api/errors/no-principal",
"title": "Forbidden",
"status": 403,
"detail": "..."
}Werte type aus, nicht title oder detail – diese sind für Menschen gedacht und können umformuliert werden.