Vai al contenuto

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

POST/api/embeds/resolve

Auth
Richiede un token
X-CommunityId
X-CommunityId Invia l’X-CommunityId della community in cui avviene l’operazione.
Le descrizioni degli endpoint provengono dalla specifica dell’API e per ora sono in portoghese. L’interfaccia intorno è tradotta.

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.

Header

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

Corpo della richiesta application/json

NomeTipoDescrizione
urlobbligatoriostringLink http ou https. · max 2048

Risposte

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

Esempio con 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"}'