Estado de la sincronización de trabajos
/cdi/integrations/{integration_id}/job_sync_status
Utilice este punto final para devolver una lista de estados de sincronización anteriores para una integración determinada.
Para utilizar este punto final, deberás generar una clave de API con el permiso .
Límite de velocidad
Este punto final tiene un límite de velocidad de 100 peticiones por minuto.
Parámetros de la ruta
Parámetro | Obligatoria | Tipo de datos | Descripción |
---|---|---|---|
integration_id |
Obligatoria | Cadena | ID de integración. |
Parámetros de consulta
Cada llamada a este punto final devolverá 10 elementos. Para una integración con más de 10 sincronizaciones, utilice el encabezado Link
para recuperar los datos en la página siguiente, como se muestra en el siguiente ejemplo de respuesta.
Parámetro | Obligatoria | Tipo de datos | Descripción |
---|---|---|---|
cursor |
Opcional | Cadena | Determina la paginación del estado de sincronización. |
Ejemplo de solicitud
Sin cursor
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/cdi/integrations/00000000-0000-0000-0000-000000000000/job_sync_status' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Con cursor
1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/cdi/integrations/00000000-0000-0000-0000-000000000000/job_sync_status?cursor=c2tpcDow' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'
Respuesta
Ejemplo de respuesta satisfactoria
El código de estado 200
podría devolver el siguiente cuerpo de respuesta.
La cabecera Link
no existirá si hay menos o igual a 10 sincronizaciones en total. En las llamadas sin cursor, prev
no se mostrará. Al consultar la última página de elementos, next
no se mostrará.
1
Link: </cdi/integrations/00000000-0000-0000-0000-000000000000/job_sync_status?cursor=c2tpcDow>; rel="prev",</cdi/integrations00000000-0000-0000-0000-000000000000/job_sync_status?cursor=c2tpcDoxMDA=>; rel="next"
1
2
3
4
5
6
7
8
9
10
11
12
13
{
"results": [
{
"job_status": (string) status of the sync, see below for explanation of different statuses,
"sync_start_time": (string) time the sync started in ISO 8601,
"sync_finish_time": (string) time the sync finished in ISO 8601,
"last_timestamp_synced": (string) last UPDATED_AT timestamp processed by the sync in ISO 8601,
"rows_synced": (integer) number of rows successfully synced to Braze,
"rows_failed_with_errors": (integer) number of rows failed because of errors,
},
],
"message": "success"
}
job_status | Explicación |
---|---|
running |
El trabajo se está ejecutando actualmente. |
success |
Todas las filas se han sincronizado correctamente. |
partial |
Algunas filas no se sincronizaron debido a errores. |
error |
No se ha sincronizado ninguna fila. |
config_error |
Se ha producido un error en la configuración de la integración. Compruebe su configuración de integración. |
Solución de problemas
La siguiente tabla enumera los posibles errores devueltos y los pasos asociados para solucionarlos.
Error | Solución de problemas |
---|---|
400 Invalid cursor |
Compruebe que su cursor es válido. |
400 Invalid integration ID |
Compruebe que su integration_id es válido. |
Para conocer otros códigos de estado y mensajes de error asociados, consulte Errores fatales y respuestas.