Saltar al contenido

Baixa o cartão do reconhecimento (PNG)

GET/api/recognitions/{id}/card

Auth
Requiere token
Clave de API:
No acepta clave de API
X-CommunityId
X-CommunityId Envía el X-CommunityId de la comunidad en la que ocurre la operación.
Las descripciones de los endpoints vienen de la especificación de la API y, por ahora, están en portugués. La interfaz alrededor está traducida.

Imagem de 1200 px de largura para compartilhar, com a altura do conteúdo, entre 1,91:1 e 1:1,25 (a faixa que o feed do LinkedIn mostra bem); mensagem longa é cortada em 8 linhas com "…". No topo, a arte do tipo em 3:1 (a mesma `artUrl` do feed) e, à esquerda dela, onde a arte padrão deixa o espaço livre, a frase do tipo, a foto e o nome de quem foi reconhecido (até 4 nomes e "mais N"), em texto escuro com contraste de pelo menos 4,5:1. Numa arte própria, a esquerda ganha um leve tom escuro e, se o texto ainda não passar, um véu branco suave. A foto de quem reconheceu aparece pequena sobre a de quem recebeu. Abaixo da arte, como no card do app: a frase "**Ana** reconheceu **Bruno** por **Colaboração**" (até 2 nomes e "mais N"), a data numa linha própria, a mensagem como citação com uma barra fina na cor da comunidade e o logo. Nada além do que o feed já mostra (nem e-mail, nem papel). Podem baixar quem deu, quem recebeu e a equipe (owner, admin, moderador, financeiro); outra pessoa que lê o reconhecimento recebe 403. Quem não vê o reconhecimento, ou reconhecimento apagado: 404. Textos fixos no idioma do `Accept-Language`. `download=false` devolve a imagem para exibir (`inline`) em vez de baixar.

Parámetros

NombreDóndeTipoDescripción
idobligatoriopathstring (uuid)
downloadopcionalqueryboolean

Headers

NombreTipoDescripción
X-CommunityIdopcionalstring (uuid)ID da comunidade em que a operação acontece. Obrigatório na maioria dos endpoints com escopo de comunidade.

Respuestas

CódigoDescripción
200O PNG (`recognition-<id>.png`).
401Token ausente, inválido ou expirado; token de outra comunidade (o `X-CommunityId` ou o `communityId` do corpo não é o do token); token antigo ou de uma sessão encerrada (troca de senha, convite aceito). Nesses casos a mensagem pede para entrar de novo (`auth.signInAgain`).
403Autenticado, mas sem permissão para esta operação.
404Recurso não encontrado.

Ejemplo con curl

curl -X GET "https://api.memberfy.net/api/recognitions/<id>/card" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID"