ACDA (App Content Delivery API)

Última actualización: 22 de junio de 2026

ACDA (App Content Delivery API) es una API de solo lectura que entrega el Content y el Media publicados a los miembros registrados en el producto, es decir, a los ServiceUser. Cuando quien opera el Space publica el contenido, los miembros lo leen a través de ACDA. Puede entenderse como la versión para ServiceUser que cumple, con identidad de miembro, el mismo papel que CDA al entregar el contenido publicado a los visitantes públicos. ACDA solo tiene endpoints de consulta (GET); la creación, modificación y eliminación corresponden a ACMA.

Las llamadas a ACDA usan el token Bearer emitido por ServiceLogin. Ese token solo es válido en ACMA y ACDA, y no puede usarse en CMA ni CDA (consulte el flujo de emisión de tokens en la Auth API).

Diferencias con CDA

La forma de respuesta de ACDA es igual a la de CDA. Entrega únicamente la instantánea del material publicado (en sys incluye solo revision, la versión del momento de la publicación, sin version, status ni publish) y, en la consulta, el idioma a recibir se define con locale. Las diferencias con CDA son el alcance de lectura y la identidad.

  • Alcance de lectura por miembro: en CDA, cualquiera que llame con un mismo DeliveryAccessToken ve el mismo conjunto publicado. ACDA devuelve solo lo permitido para el ServiceUser que realiza la llamada, y lo que se permite se determina según el ServiceUserRole y las asignaciones de ese miembro. La identidad también difiere: CDA se llama con un DeliveryAccessToken y ACDA con el token de miembro emitido por ServiceLogin.

La forma de definir en qué idioma se recibe mediante el parámetro de consulta locale también es igual a la de CDA. Si se indica un código como locale=ko-KR, devuelve fields con el único valor de ese locale (si no existe y el Fallback tampoco lo alcanza, queda vacío o null); si se omite, lo devuelve del mismo modo con el Locale predeterminado del Space; y si se indica locale=*, devuelve tal cual un mapa con los valores de todos los locales. En los dos primeros casos, en los que se recibe en un solo idioma, se incluye la cabecera x-weegloo-locale que indica el locale realmente usado (con locale=* no se incluye).

Estructura del recurso

La siguiente es la forma en que ACDA entrega un Content "Producto" del Space de demostración. Es el resultado de la consulta con locale=ko-KR, y cada valor de fields contiene el único valor de ko-KR.

{
  "sys": {
    "id": "3trmXRM3RqbgSnifyg7OGhwhlqvAvq",
    "type": "Content",
    "space": { "sys": { "id": "HnQ32YiH", "type": "Refer", "targetType": "Space" } },
    "contentType": { "sys": { "id": "3trmXRLdJF4GBlAjtcuoZ7Pnxj8dlA", "type": "Refer", "targetType": "ContentType" } },
    "createdAt": "2026-06-15T15:16:12.151Z",
    "updatedAt": "2026-06-16T14:35:11.210Z",
    "revision": 3
  },
  "fields": {
    "productName": "스테인리스 텀블러 500ml",
    "price": 18000,
    "description": "이중 진공 단열로 보온·보냉이 오래갑니다. 500ml 대용량."
  }
}

Claves principales:

  • sys.id: identificador único del Content. Se coloca en el {contentId} de la ruta de consulta individual.
  • sys.type: tipo de recurso; para Content es siempre "Content".
  • sys.space: referencia que apunta al Space al que pertenece este Content.
  • sys.contentType: referencia que apunta al Content Type que sigue este Content.
  • sys.revision: la versión en el momento de la publicación. Cada vez que se publica, aquí se guarda la versión de ese momento. Como ACDA no incluye version, status ni publish de gestión, el único valor que indica la versión publicada es revision.
  • sys.createdBy y sys.updatedBy: se incluyen únicamente cuando el publishWithAuthor del Content Type está activado, y apuntan al autor y al editor. En el ejemplo anterior esta opción está desactivada, por lo que ambas claves se omiten.
  • fields: contiene el valor de cada campo en la forma { apiName: value }. A diferencia del mapa de locales de CMA y ACMA ({ apiName: { locale: value } }), ACDA contiene únicamente el valor del locale consultado. En el ejemplo anterior, la foto principal photo se omite porque no tiene valor en ese locale.

El Media también se devuelve con la misma forma de entrega de lo publicado: en sys incluye solo revision y no incluye version, status ni publish. El Media omite siempre la información de autoría (createdBy y updatedBy). El fields.file del Media también se devuelve como un único objeto del locale consultado.

API

Los tres endpoints son de consulta (GET) y el idioma a recibir se define con el parámetro de consulta locale (si es un código, ese locale; si se omite, el Locale predeterminado; si es *, el mapa completo; consulte arriba).