Saltar al contenido

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

POST/api/embeds/resolve

Auth
Requiere token
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.

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

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

Cuerpo de la solicitud application/json

NombreTipoDescripción
urlobligatoriostringLink http ou https. · max 2048

Respuestas

CódigoDescripción
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.

Ejemplo 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"}'