Desencadenar una sincronización
/cdi/integrations/{integration_id}/sync
Utiliza este endpoint para iniciar una sincronización para una integración determinada de inmediato, por ejemplo, cuando finaliza la carga de tu almacén de datos. Las sincronizaciones bajo demanda se ejecutan de forma adicional a cualquier programación recurrente y no la modifican. Si ya se está ejecutando una sincronización para la integración, la solicitud devuelve
429.
Para utilizar este endpoint, debes generar una clave de API con el permiso cdi.integration_sync.
Límite de velocidad
Este endpoint tiene un límite de velocidad de 20 solicitudes por minuto.
Parámetros de la ruta
| Parámetro | Obligatorio | Tipo de datos | Descripción |
|---|---|---|---|
integration_id |
Obligatorio | Cadena | ID de integración. Se encuentra en la URL cuando se visualiza una integración en el panel de Braze. El formato de la URL es https://[instance].braze.com/integrations/cloud_data_ingestion/[integration_id]. |
Ejemplo de solicitud
curl --location --request POST 'https://rest.iad-03.braze.com/cdi/integrations/00000000-0000-0000-0000-000000000000/sync' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Respuesta
Ejemplo de respuesta satisfactoria
El código de estado 202 podría devolver el siguiente cuerpo de respuesta:
{
"message": "success"
}
Solución de problemas
La siguiente tabla enumera los posibles errores devueltos y sus pasos asociados para la solución de problemas.
| Error | Solución de problemas |
|---|---|
400 Invalid integration ID |
Comprueba que tu integration_id sea válido. |
404 Integration not found |
No existe ninguna integración para el ID de integración dado. Asegúrate de que tu ID de integración sea válido. |
409 Integration must be active to trigger a sync |
La integración no está activa. Esto puede ocurrir cuando la sincronización está en pausa. Reanuda la sincronización en el panel de Braze e inténtalo de nuevo. |
429 Another job is in progress |
Actualmente se está ejecutando una sincronización para esta integración. Inténtalo de nuevo cuando se haya completado la sincronización. |
Para obtener más códigos de estado y mensajes de error asociados, consulta Errores fatales y respuestas.