Catalog Service Guía de API

Catalog Service es el sistema de registro para la ubicación y el linaje de datos dentro de Adobe Experience Platform. Catalog actúa como un almacén de metadatos o un "catálogo" donde puede encontrar información sobre sus datos dentro de Experience Platform, sin necesidad de acceder a los datos en sí. Consulte Catalog overview para obtener más información.

Esta guía para desarrolladores proporciona pasos para ayudarle a empezar a utilizar la API Catalog. A continuación, la guía proporciona ejemplos de llamadas de API para realizar operaciones clave mediante Catalog.

Requisitos previos

Catalog rastrea metadatos para varios tipos de recursos y operaciones dentro de Experience Platform. Esta guía para desarrolladores requiere comprender bien los distintos Experience Platform servicios relacionados con la creación y administración de estos recursos:

  • Experience Data Model (XDM): El marco estandarizado mediante el cual se Platform organizan los datos de experiencia del cliente.
  • Ingesta por lotes: Cómo Experience Platform se introducen y almacenan datos de archivos de datos, como CSV y Parquet.
  • ingesta de transmisión: Cómo Experience Platform ingesta y almacena datos de dispositivos del lado del cliente y del servidor en tiempo real.

Las secciones siguientes proporcionan información adicional que debe conocer o tener disponible para realizar llamadas correctamente a la API Catalog Service .

Leer llamadas de API de ejemplo

Esta guía proporciona ejemplos de llamadas a la API para demostrar cómo dar formato a las solicitudes. Estas incluyen rutas de acceso, encabezados necesarios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de API. Para obtener información sobre las convenciones utilizadas en la documentación para las llamadas de API de ejemplo, consulte la sección sobre cómo leer llamadas de API de ejemplo en la guía de solución de problemas Experience Platform.

Recopilar valores para encabezados necesarios

Para realizar llamadas a las API Platform, primero debe completar el tutorial de autenticación. Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados necesarios en todas las llamadas a la API Experience Platform, como se muestra a continuación:

  • Autorización: Portador {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

Todos los recursos de Experience Platform están aislados en entornos limitados virtuales específicos. Todas las solicitudes a las API Platform requieren un encabezado que especifique el nombre del simulador para pruebas en el que se realizará la operación:

  • x-sandbox-name: {SANDBOX_NAME}
NOTA

Para obtener más información sobre los entornos limitados en Platform, consulte la documentación general del entorno limitado.

Todas las solicitudes que contienen una carga útil (POST, PUT, PATCH) requieren un encabezado adicional:

  • Content-Type: application/json

Prácticas recomendadas para llamadas de API Catalog

Al realizar solicitudes de GET a la API Catalog, se recomienda incluir parámetros de consulta en las solicitudes para devolver solo los objetos y las propiedades que necesite. Las solicitudes sin filtrar pueden hacer que las cargas de respuesta superen los 3 GB de tamaño, lo que puede ralentizar el rendimiento general.

Puede ver objetos específicos incluyendo su ID en la ruta de la solicitud o utilizando parámetros de consulta como properties y limit para filtrar las respuestas. Los filtros se pueden pasar como encabezados y como parámetros de consulta, con prioridad para los que se pasan como parámetros de consulta. Consulte el documento sobre filtrado de datos del catálogo para obtener más información.

Dado que algunas consultas pueden suponer una carga pesada para la API, se han implementado límites globales en las Catalog consultas para admitir más prácticas recomendadas.

Pasos siguientes

Este documento abarcaba los conocimientos previos necesarios para realizar llamadas a la API Catalog. Ahora puede continuar con las llamadas de ejemplo que se proporcionan en esta guía para desarrolladores y seguir junto con sus instrucciones.

La mayoría de los ejemplos de esta guía utilizan el extremo /dataSets , pero los principios se pueden aplicar a otros extremos dentro de Catalog (como /batches y /accounts). Consulte la Referencia de la API del servicio de catálogo para obtener una lista completa de todas las llamadas y operaciones disponibles para cada extremo.

Para ver un flujo de trabajo paso a paso que muestre cómo la API Catalog está implicada en la ingesta de datos, consulte el tutorial sobre la creación de un conjunto de datos.

En esta página

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now