Saltar para o conteúdo

Resolve um link para player ou cartão de pré-visualização

POST/api/embeds/resolve

Auth
Exige token
X-CommunityId
X-CommunityId Envie o X-CommunityId da comunidade em que a operação acontece.

O editor chama ao colar um link, para mostrar o embed exatamente como ele vai aparecer no post. Qualquer membro da comunidade. Players nativos: YouTube (vídeo, `/live`, `youtu.be`, início em `t=`), Spotify, Vimeo, Loom, SoundCloud, Google Maps, post e reel do Instagram, post do LinkedIn. Os demais viram cartão (Open Graph, Twitter Card, título e descrição da página): X/Twitter, lojas de aplicativo (`type: app`), WhatsApp (sem buscar nada), perfis, canais e sites em geral. Encurtadores (bit.ly e outros) são seguidos (até 5 saltos) e o destino é resolvido. GIF e imagem direta voltam como `type: image`. Resultado guardado por 7 dias por link (5 minutos quando a página não respondeu: volta um cartão mínimo com o domínio). Endereço privado ou reservado (localhost, rede interna, metadados de nuvem) é recusado com 422, também quando aparece no meio de um redirecionamento. Limites (429 com `Retry-After`): 30 chamadas por minuto por pessoa e 300 por comunidade; e, entre elas, links que ainda não estão no cache (lidos da web) até 10 por minuto por pessoa e 60 por comunidade. Variações do mesmo link (maiúsculas, barra final, âncora, `utm_*`, ordem da query, http ou https) contam como um só. Link para IP, nome interno ou porta diferente de 80/443 é recusado (422). `url` e `canonicalUrl` servem só como link (abrir com `rel="noopener nofollow"`), nunca para carregar.

Headers

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

Corpo da requisição application/json

NomeTipoDescrição
urlobrigatóriostringLink http ou https. · max 2048

Respostas

CódigoDescrição
200O embed do link.
400Requisição inválida — falha de validação.
401Token ausente, inválido ou expirado.
403Autenticado, mas sem permissão para esta operação.
422Link inválido (`errors[0].param = "url"`) ou que aponta para endereço privado.
429Muitas resoluções em pouco tempo.
500Erro interno do servidor.

Exemplo com curl

curl -X POST "https://api.memberfy.net/api/embeds/resolve" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-CommunityId: $COMMUNITY_ID" \
  -H "Content-Type: application/json" \
  -d '{"url":"string"}'