Skip to content

Disparar uma sincronização

post

/cdi/integrations/{integration_id}/sync

Use este endpoint para disparar uma sincronização para uma determinada integração.

Limite de taxa

Esse endpoint tem um limite de taxa de 20 solicitações por minuto.

Parâmetros de caminho

Parâmetro Obrigatória Tipo de dados Descrição
integration_id Obrigatória String ID de integração. Isso é encontrado na URL ao visualizar uma integração no dashboard da Braze. O formato da URL é https://[instance].braze.com/integrations/cloud_data_ingestion/[integration_id].

Exemplo de solicitação

1
2
3
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'

Resposta

Exemplo de resposta bem-sucedida

O código de status 202 pode retornar o seguinte corpo de resposta:

1
2
3
{
  "message": "success"
}

Solução de problemas

A tabela a seguir lista os possíveis erros retornados e as etapas de solução de problemas associadas.

Erro Solução de problemas
400 Invalid integration ID Verifique se o integration_id é válido.
404 Integration not found Não existe integração para o ID de integração fornecido. Certifique-se de que seu ID de integração é válido.
429 Another job is in progress Há uma sincronização em execução para esta integração. Tente novamente após a sincronização ser concluída.

Para códigos de status adicionais e mensagens de erro associadas, consulte Erros fatais e respostas.

New Stuff!