Zum Hauptinhalt springen

Kein Mitglied

typehttps://docs.frem.sh/reference/api/errors/not-a-member
HTTP-Status403 Forbidden

Was das bedeutet

Der Login im Anfragepfad ist kein Mitglied der Organisation, die im selben Pfad steht, daher wurde die Anfrage abgelehnt, ohne etwas zu tun.

Das ist eine bewusste Grenze, kein Berechtigungsproblem deines Tokens: Ein Endpunkt auf Mitgliederebene handelt nur für Mitglieder der Organisation, die du angesprochen hast. So lässt sich keine Einstellung für einen Nutzer ändern, der zufällig denselben Login-Namen hat wie jemand in einer anderen Organisation.

Was du tun kannst

Prüfe die Schreibweise des Logins und vergewissere dich, dass der Nutzer Mitglied dieser Organisation ist:

curl -H "Authorization: Bearer $FREMFORGE_TOKEN" \
  https://frem.sh/api/v1/orgs/<org>/members

Füge ihn zuerst der Organisation hinzu, falls er fehlt. Der Login wird ohne Rücksicht auf Groß- und Kleinschreibung verglichen, daher liegt es nicht an der Schreibweise allein.

Nicht zu verwechseln mit

FehlerBedeutung
not-foundEinen solchen Nutzer gibt es nirgends auf der Instanz.
forgejo-unavailableDie Mitgliedschaft ließ sich gar nicht prüfen – ein vorübergehender Fehler, keine Aussage über die Mitgliedschaft. Versuche es erneut.

Diese letzte Unterscheidung ist beim Skripten wichtig: Ein 403 ist eine feste Antwort, und ein erneuter Versuch ändert daran nichts, während ein 503 wiederholt werden sollte.

Form der Antwort

Alle Fehler der fremforge-API sind RFC 9457 problem+json:

{
  "type": "https://docs.frem.sh/reference/api/errors/not-a-member",
  "title": "Forbidden",
  "status": 403,
  "detail": "<login> is not a member of this organisation."
}

Werte type aus, nicht title oder detail – diese sind für Menschen gedacht und können umformuliert werden.

Kein MandantKein Muster