Listar estado de sincronización de trabajos

Usa este punto de conexión para devolver una lista de estados de sincronización anteriores para una integración determinada.

Nota

Para usar este punto de conexión, deberás generar una clave de API con el permiso cdi.integration_job_status.

Límite de velocidad

Este punto de conexión tiene un límite de velocidad de 100 solicitudes por minuto.

Parámetros de la ruta

Parámetros de consulta

Cada llamada a este punto de conexión devolverá 10 elementos. Para una integración con más de 10 sincronizaciones, usa el encabezado Link para recuperar los datos en la página siguiente, como se muestra en el siguiente ejemplo de respuesta.

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 correcta

El código de estado 200 podría devolver el siguiente cuerpo de respuesta.

Nota

El encabezado Link no existirá si hay 10 sincronizaciones o menos 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"
}

Solución de problemas

La siguiente tabla enumera los posibles errores devueltos y sus pasos asociados para la solución de problemas.

Para obtener más códigos de estado y mensajes de error asociados, consulta Errores fatales y respuestas.