From 483659f7d252f6f1510aad42e914885f0f412550 Mon Sep 17 00:00:00 2001 From: Joas Schilling Date: Thu, 7 Mar 2024 12:18:03 +0100 Subject: feat(federation): Add endpoint to get the proxied avatar of other users Signed-off-by: Joas Schilling --- docs/avatar.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) (limited to 'docs') diff --git a/docs/avatar.md b/docs/avatar.md index 7fc908c44..c15948924 100644 --- a/docs/avatar.md +++ b/docs/avatar.md @@ -92,3 +92,39 @@ + `200 OK` + `404 Not Found` When the conversation could not be found for the participant - Body: the image file + +## Get federated user avatar (binary) + +* Required capability: `federation-v1` +* Method: `GET` +* Endpoint: `/proxy/{token}/user-avatar/{size}` +* Data: + +| field | type | Description | +|-----------|--------|------------------------------------------| +| `size` | int | Only 64 and 512 are supported | +| `cloudId` | string | Federation CloudID to get the avatar for | + +* Response: + - Status code: + + `200 OK` + + `404 Not Found` When the conversation could not be found for the participant + - Body: the image file + +## Get dark mode federated user avatar (binary) + +* Required capability: `federation-v1` +* Method: `GET` +* Endpoint: `/proxy/{token}/user-avatar/{size}/dark` +* Data: + +| field | type | Description | +|-----------|--------|------------------------------------------| +| `size` | int | Only 64 and 512 are supported | +| `cloudId` | string | Federation CloudID to get the avatar for | + +* Response: + - Status code: + + `200 OK` + + `404 Not Found` When the conversation could not be found for the participant + - Body: the image file -- cgit v1.2.3