Skip to content

Baixa o cartão do reconhecimento (PNG)

GET/api/recognitions/{id}/card

Auth
Requires a token
API key:
No API key accepted
X-CommunityId
X-CommunityId Send the X-CommunityId of the community the operation happens in.
Endpoint descriptions come straight from the API specification and are in Portuguese for now. The interface around them is translated.

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.

Parameters

NameInTypeDescription
idrequiredpathstring (uuid)
downloadoptionalqueryboolean

Headers

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

Responses

StatusDescription
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.

curl example

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