Przejdź do dokumentacji
API

Usuń członka

Obie osie naraz: rola i każde uprawnienie do adresu, jakie tu mają.

DELETEapi.openemail.uk/members/{userId}

Uruchamia prawdziwe wywołanie na twojej przestrzeni roboczej, twoim własnym kluczem.

DELETE /members/{userId}

Obie osie naraz: rola i każde uprawnienie do adresu, jakie tu mają.

Przykład

Wymaga members:write.

curl
curl -X DELETE "$OE/members/7fQ2mN8vBz1aRd4tYwKx7fQ2mN8vBz1a" -H "$AUTH"
Odpowiedź
{  "object": "member",  "userId": "7fQ2mN8vBz1aRd4tYwKx7fQ2mN8vBz1a",  "deleted": true,  "addressesRevoked": 2}

Oba nadania znikają razem. Usunięcie samego wiersza członka byłoby najgorszym z obu wyników: zniknął z tej listy, a nadal czyta pocztę.

NIE zwraca 404 dla kogoś, kto nie jest członkiem, i nie jest to pobłażliwość wobec identyfikatorów. Populacją, do której ten endpoint najbardziej musi dotrzeć, są posiadacze starszych uprawnień, którzy mają uprawnienia do adresów i w ogóle nie mają wiersza członka, więc wstępne sprawdzenie „czy jest wiersz członka” odrzucałoby dokładnie te osoby, którym dostęp najbardziej trzeba odebrać. addressesRevoked mówi, co faktycznie się stało, a zero w nim jest uczciwym raportem z braku zmian.

Usuwa ich z JEDNEJ przestrzeni roboczej. Ich konto OpenEmail pozostaje nietknięte, tak samo jak każdy dostęp, jaki mają gdzie indziej.

Aby odebrać jeden adres i zostawić osobę na miejscu, użyj zamiast tego DELETE /members/{userId}/addresses/{addressId}. To wywołanie dla kogoś, kto zmienił zespół, a nie dla kogoś, kto odszedł.