Uso de la API de eventos en recorridos en tiempo real

La API de eventos es un método de programación para acceder a datos de eventos, sesiones, pistas de sesión, pases, oradores y patrocinios. Además, la API de eventos permite registrarse para eventos y sesiones.

El acceso a la API se realiza a través del protocolo HTTPS y se accede desde el punto de conexión de API que recibe al crear un token de aplicación web. Todos los datos se envían y reciben en formato JSON.

Registro para la API de eventos

En la sección Configuración, enAplicaciones web> de eventos, cree una nueva aplicación web. Es importante seleccionar el origen correcto. Por ejemplo, si selecciona https://contoso.com, JavaScript alojado en un dominio diferente no podrá acceder a la API administración de eventos.

Después de crear una aplicación web, verá un vínculo a la especificación de OpenAPI en la Documentación de punto de conexión (versión preliminar).

Puede seleccionar el vínculo y copiar y pegar el contrato de API en un editor de OpenAPI, como Swagger Editor, que genera automáticamente un contenedor que puede usar para detectar la API. Para acceder a su API, debe estar autorizado (proporcionar la columna Token).

Creación de una página de eventos o un portal de eventos

La API de eventos permite crear una página de eventos personalizada y un portal de eventos que muestra todos los eventos disponibles que están activos y publicados mediante la opción de publicación "Solución personalizada mediante la API de eventos". La API de eventos le permite:

• Recupere una lista de eventos en directo que incluyan su nombre, descripción, ubicación y hora.
• Para la página de eventos, permite recuperar información clave sobre el evento, como:
  • Nombre
  • Time
  • Ubicación
  • Código QR de evento
  • Capacity
  • Lista de sesiones
  • Lista de hablantes
  • Lista de patrocinadores y sus logotipos

Creación de una experiencia de registro de eventos personalizada

La API de eventos también le permite crear un envío de registro sin necesidad de usar formularios de marketing en tiempo real, a la vez que se beneficia de características importantes, como la estrategia de coincidencia, el consentimiento, la configuración de audiencia, etc.

En primer lugar, defina la configuración clave para su audiencia navegando a Configuración>Gestión de eventos>Configuración del registro de eventos y defina:

1. Audiencia predeterminada
2. Regla de coincidencia predeterminada
3. Perfil de cumplimiento predeterminado

La configuración de registro de eventos predeterminada se usa al procesar envíos desde la API. Una vez establecida la configuración de registro, el punto de conexión para la submisión de la API de eventos le permite:

1. Cree un envío de registro para un evento:

{ 
    "attendees": [ 
        { 
            "lastName": "Sample Contact Last Name", 
            "firstName": "Sample Contact First Name", 
            "email": "[email protected]", 
            "responses": [ 
                { 
                    "id": "jobtitle", 
                    "value": "Sample Contact Job Title" 
                }, 
                { 
                    "id": "customUnmappedField1", 
                    "value": "Sample Custom Unmapped Field 1" 
                }, 
                { 
                    "id": "customUnmappedField2", 
                    "value": "Sample Custom Unmapped Field 2" 
                } 
            ] 
        } 
    ] 
}

2. Cree un envío de registro para una sesión:

{ 
    "attendees": [ 
        { 
            "lastName": "Sample Contact Last Name", 
            "firstName": "Sample Contact First Name", 
            "email": "[email protected]", 
            "responses": [ 
                { 
                    "id": "jobtitle", 
                    "value": "Sample Contact Job Title" 
                } 
            ], 
            "attendeeSessions": [ 
                { 
                    "sessionId": "d5f513c6-989f-f011-bbd3-000d3a5b6385" 
                }, 
                { 
                    "sessionId": "f5d4e4b9-989f-f011-bbd3-000d3a5b6385" 
                } 
            ] 
        } 
    ] 
} 

3. Cree un registro de lista de espera:

{
    "attendees": [ 
        { 
            "lastName": "Sample Contact Last Name", 
            "firstName": "Sample Contact First Name", 
            "email": "[email protected]", 
            "waitlisted": true, 
            "responses": [ 
                { 
                    "id": "jobtitle", 
                    "value": "Sample Contact Job Title" 
                }, 
                { 
                    "id": "customUnmappedField1", 
                    "value": "Sample Custom Unmapped Field 1" 
                }, 
                { 
                    "id": "customUnmappedField2", 
                    "value": "Sample Custom Unmapped Field 2" 
                } 
            ] 
        } 
    ]
}

Rendimiento y límites

La API de eventos admite escenarios de registro de gran volumen a través del procesamiento asincrónico, el almacenamiento en caché inteligente y la lógica de reintento integrada.

Cuando una solicitud de registro llega a través de la API de eventos, el sistema:

• Valida que el evento está activo y que todas las entidades relacionadas están en un estado válido
• Devuelve una respuesta de éxito inmediata a quien realiza la llamada.
• Inicia un procesador de elementos de trabajo en segundo plano para crear el registro de eventos y las entidades asociadas de forma asincrónica.

Comportamiento de almacenamiento en caché

Caché de lectura: el sistema aplica una caché de 10 minutos para la validación de eventos y entidades. Esto reduce las lecturas redundantes en Dataverse y mejora el rendimiento bajo carga.

Control de errores y lógica de reintento

Si el procesador en segundo plano no puede crear un registro de eventos, el sistema reintenta automáticamente hasta seis horas. Esto se aplica a escenarios de error sincrónicos y asincrónicos, lo que garantiza la confiabilidad de los datos sin necesidad de intervención manual.

Límites de capacidad de procesamiento y de Dataverse

El principal factor limitante en los escenarios de registro sin formulario es la velocidad a la que pueden crearse entidades de registro de tickets en Dataverse. En condiciones normales, Dataverse aplica un límite de 6000 solicitudes de API, dentro de una ventana deslizante de cinco minutos, por usuario y servidor web. La plataforma puede devolver un 429 Too Many Requests error si se superan estos límites. Más información: Límites de api de protección de servicios.