CDA (Content Delivery API)

Última atualização: 3 de julho de 2026

A CDA (Content Delivery API) é uma API somente leitura que entrega Content, Media e afins publicados aos visitantes. Quando quem opera o Space cria e publica conteúdo no estúdio de conteúdo ou pela CMA, o site ou aplicativo lê essa versão publicada pela CDA e a exibe na tela. Criar, editar e publicar é responsabilidade da CMA, não da CDA.

A URL base é https://cda.weegloo.com/v1. Para autenticação costuma-se usar um DeliveryAccessToken least-privilege. É um token que tem apenas o escopo necessário, de modo a ser seguro para entrega pública no navegador. Também é possível ler com um Weegloo User Bearer token, mas, como ele tem permissões excessivas para distribuição no navegador, recomenda-se o DeliveryAccessToken.

Comportamento comum

O que segue se aplica a todos os recursos da CDA. Cada página de recurso assume esse comportamento e trata apenas do que lhe é próprio.

  • Somente leitura. Todos os endpoints são de consulta (GET). Escrita e publicação são competência da CMA.

  • Só o que está publicado aparece. De Content, Media e Content Type só é entregue o snapshot publicado. O Draft da CMA e as alterações não publicadas não aparecem na CDA.

  • sys do snapshot publicado. O sys desses três recursos não tem o version, o status nem o publish de gestão, e sim apenas o revision, que aponta para a versão do momento em que foi tornada pública. (O Locale não é alvo de publicação, e sim um recurso de configuração, por isso mantém o version normalmente.)

  • Seleção de idioma com locale. A consulta de Content e Media define em qual idioma receber por meio do parâmetro de query locale. Funciona de três formas.

    • Ao informar um código como locale=ko-KR, devolve fields com um único valor desse locale (não um mapa de locales). Se não houver valor e o Fallback também não alcançar, esse campo fica vazio ou null.
    • Ao omitir, devolve da mesma forma, mas usando o Locale padrão do Space.
    • Ao informar locale=*, não escolhe um único idioma, e sim devolve tal como está o mapa com os valores de todos os locales ({ apiName: { locale: value } }).

    Nos dois primeiros casos, em que se recebe um único idioma, a resposta inclui o cabeçalho x-weegloo-locale, que informa o locale efetivamente usado (quando locale=*, ele não é incluído). (O Content Type é o schema do molde, por isso não recebe locale, e o Sync não escolhe idioma, entregando tal como está o mapa de locales.)

  • Exposição do autor. O createdBy e o updatedBy de Content só são entregues quando o publishWithAuthor daquele Content Type está ativado. O Media sempre omite as informações de autor.

Recursos

  • Content Type: consulta o Content Type publicado (o molde do conteúdo e a definição dos campos).
  • Content: consulta o Content publicado por lista completa, individualmente ou por Content Type.
  • Media: consulta o Media (recurso de arquivo) publicado e a URL de entrega.
  • Locale: consulta a configuração de idiomas que o Space suporta (code, se é padrão e fallbackCode). Por ser um recurso de configuração, tem version no sys.
  • Sync: sincronização incremental que recebe apenas o que mudou ou foi excluído desde a última sincronização. Entrega os valores tal como estão no mapa de locales e não escolhe um único idioma.
  • CMA Content Type: a API de gestão para criar, editar e publicar o molde do conteúdo e o próprio conteúdo.
  • ACDA: a versão que realiza a mesma entrega com a identidade de membro (ServiceUser).