3.2 KiB
C211-FOLLOWUP-OEMBED — C211 — link de terceiro: o oEmbed não permite persistir metadados/conteúdo
Status: rascunho
Atualizado em: 2026-09-22
Issue: (registrada via pnpm agent:register; destrava quando o C211 flipar done)
Priority: P2
Impeccable: A — N/A sem UI
Design UI: N/A — sem UI
Appetite: ~30 min de ajuste documental no C211 (fill-in); nenhum código nasce aqui
Responsável: —
Intenção
A investigação do C212 (Issue #1256, achados em docs/plans/central-conteudos-varredura-instagram.md §Q2) provou que o oEmbed do Instagram só serve para renderizar o post embutido (visão de front-end): "consuming, manipulating, extracting, or persisting the metadata and content … is strictly prohibited" (doc datada em 2026-09-22; probe sem credencial devolveu 403 Provide valid app ID ao pedir metadados). O plano do C211 (Issue #1254, in-progress) ainda carrega a hipótese B ("entra com thumbnail/embed quando o caminho oficial permitir") na questão em aberto "Peça por link: circula ou é baixada?" — interpretável como persistir thumbnail de terceiro, o que a plataforma proíbe.
Este item garante que, quando o C211 for implementado/refinado, a regra chegue ao plano dele: peça de terceiro circula pelo link; o embed pode ser renderizado; nada é extraído, baixado ou persistido de terceiro; catalogação/extração de arquivo só da conta própria via Graph API.
Objetivo e aceite
- Ao destravar (C211
done), aplicar no plano/impl do C211 a linha de refinamento na questão "Peça por link" (docs/plans/central-conteudos-ingestao.md:105) e, se o aceite:49ainda prometer thumbnail de terceiro, alinhar o texto ao limite do oEmbed — citandodocs/plans/central-conteudos-varredura-instagram.md§Q2. - Nada além de documentação: sem código, sem schema, sem migration, sem Consent, sem URL.
Dados da decisão (literais)
- Guardrail: mídia de terceiro nunca é baixada (C211
:68); o C212 acrescentou o limite do oEmbed: persistir metadados/conteúdo de terceiro é proibido pela plataforma. - Caminho oficial: embed/render para terceiro; Graph API (
media_url) só para a conta própria.
Fora de escopo
- Implementar o fluxo de link (é o C211) e a varredura (item próprio descrito no C212 §Q4).
Rabbit holes de produto
- "Baixar a thumbnail porque dá." O endpoint devolve o embed, não licença de persistência. Corte: render, nunca persistir.
- "Editar o plano do C211 durante o in-progress." Proibido (regra de captura de débitos): este item só age quando o C211 fechar.
Referências
- Achados:
docs/plans/central-conteudos-varredura-instagram.md§Q2 · Plano do pai:docs/plans/central-conteudos-ingestao.md· Doc datada: Instagram oEmbed (developers.facebook.com/documentation/instagram-platform/oembed, consultado em 2026-09-22)
Self-score (shaping)
- Fatia = um outcome verificável? Sim — a regra do oEmbed no plano do C211, sem código.
- Appetite declarado e a intenção cabe? Sim (~30 min, quando destravar).
- Persona + job + aceite claros? Sim — dono do C211.
- Direção no codebase é hipótese? Sim — duas linhas de plano.
- Zero decisões duras de engenharia? Sim.
Score: 5/5.