[Beta]{class="badge informative"}
Introducción a las fuentes de autoservicio (streaming de SDK)
Las fuentes de autoservicio (Streaming SDK) le permiten integrar su propia fuente para llevar los datos de streaming a Adobe Experience Platform. Este documento proporciona una introducción a los conceptos principales que necesita conocer antes de intentar realizar llamadas a la Flow Service API.
Proceso de alto nivel
A continuación se describe el proceso paso a paso para configurar el origen en Experience Platform:
Integración
Documentación
- Para empezar a documentar el origen, lea la descripción general sobre la creación de documentación para orígenes de autoservicio.
- Lea la guía de uso de la interfaz web de GitHub para ver los pasos sobre cómo crear documentación con GitHub.
- Lea la guía de uso de un editor de texto para ver los pasos sobre cómo crear documentación con su equipo local.
- Use la plantilla de documentación de la API de Streaming SDK para documentar su origen en la API.
- Use la plantilla de documentación de la IU de Streaming SDK para documentar su origen en la IU.
También puede descargar las plantillas de documentación a continuación:
Requisitos previos
Para utilizar fuentes de autoservicio (Streaming de SDK), debe asegurarse de tener acceso a una organización de zona protegida aprovisionada con fuentes de Adobe Experience Platform.
Esta guía también requiere una comprensión práctica de los siguientes componentes de Adobe Experience Platform:
- Fuentes: Experience Platform permite la ingesta de datos de varias fuentes al tiempo que le ofrece la capacidad de estructurar, etiquetar y mejorar los datos entrantes mediante los servicios de Experience Platform.
- Zonas protegidas: Experience Platform proporciona zonas protegidas virtuales que dividen una sola instancia de Experience Platform en entornos virtuales independientes para ayudar a desarrollar y evolucionar aplicaciones de experiencia digital.
Lectura de llamadas de API de muestra
La documentación de la API de fuentes de autoservicio (Streaming SDK) y Flow Service proporciona ejemplos de llamadas a la API para mostrar cómo dar formato a las solicitudes. Estas incluyen rutas, encabezados obligatorios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de la API. Para obtener información sobre las convenciones utilizadas en la documentación de las llamadas de API de ejemplo, consulte la sección sobre cómo leer las llamadas de API de ejemplo en la guía de solución de problemas de Experience Platform.
Recopilación de valores para los encabezados obligatorios
Para realizar llamadas a las API de Experience 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 obligatorios en todas las llamadas de API de Experience Platform, como se muestra a continuación:
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
Todos los recursos de Experience Platform, incluidos los que pertenecen a Flow Service, están aislados en zonas protegidas virtuales específicas. Todas las solicitudes a las API de Experience Platform requieren un encabezado que especifique el nombre de la zona protegida en la que se realizará la operación:
x-sandbox-name: {SANDBOX_NAME}
Todas las solicitudes que contienen una carga útil (POST, PUT, PATCH) requieren un encabezado adicional:
Content-Type: application/json
Pasos siguientes
Para empezar a crear una nueva fuente con fuentes de autoservicio (Streaming SDK), consulta el tutorial de creación de una nueva fuente.