3.8 KiB
C211-FOLLOWUP-OEMBED — C211 — link de terceiro: o oEmbed não permite persistir metadados/conteúdo
Status: entregue (2026-09-23 — refinamento datado nos planos do C211; sem código) Atualizado em: 2026-09-23 Issue: #1263 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 (#200) Provide valid app ID ao pedir metadados). A hipótese B ("entra com thumbnail/embed quando o caminho oficial permitir") vivia na questão do C212 (central-conteudos-varredura-instagram.md:79) — o plano do C211 (Issue #1254) nunca a carregou: sua questão "Peça por link: circula ou é baixada?" já dizia "mídia de terceiro nunca é baixada" e ficou marcada "(decidido — refinar no C212)", interpretável como persistir thumbnail de terceiro, o que a plataforma proíbe. (Correção 2026-09-23 — Issue #1263: atribuição corrigida; a premissa original apontava a hipótese B para o plano do C211.)
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.
- (Fechamento 2026-09-23 — Issue #1263) Aplicado: a regra entrou em
docs/plans/central-conteudos-ingestao.md:68,105e no D4 do impl (central-conteudos-ingestao-impl.md:105,195,229). O aceite:49do C211 não prometia thumbnail de terceiro — nada a alinhar lá (condicional do aceite acima resolvida como falsa).
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.