Para desenvolvedores
Você move dados para dentro e consome registros dourados.
Comece aqui
- O modelo da plataforma
- Referência da API — cada endpoint
- Códigos de erro — o envelope e como ramificar nele
Seu trabalho
| Tarefa | Página |
|---|---|
| Carregar dados em volume | Execute uma carga em massa |
| Ler registros dourados | Leia a visão 360 |
| Encontrar registros | Pesquise entidades |
| Reagir a mudanças | Inscreva-se em eventos |
| Conectar um agente | Conecte um agente de IA |
Conselhos de integração
Ramifique pelo código de erro, nunca pela mensagem. Mensagens são texto de exibição e podem ser reescritas ou traduzidas; códigos são estáveis.
Exponha o identificador de rastro. Um erro que um usuário consegue reportar por identificador é diagnosticável; um descrito de memória normalmente não é.
Não trate webhooks como um fluxo completo de mudanças. A entrega é no máximo uma vez, sem reenvio automático. Trate-os como notificação de baixa latência e reconcilie contra a API.
Trate 429 e 503 respeitando o intervalo de nova tentativa. Tentar de novo imediatamente piora a condição.
Espere valores mascarados. O que você recebe depende das permissões de quem chama. Não presuma que um campo está presente porque estava na resposta de outro chamador.
Carregando bem
Carregue na ordem de dependência — dados de referência, entidades, relacionamentos — e use a opção de carga inicial na primeira carga numa organização. Compare depois de carregar: comparar um conjunto parcialmente carregado pontua concordâncias alto demais, porque as frequências de valor cobrem apenas uma fração dos dados.
Sucesso parcial é normal. Leia os erros por linha e reenvie apenas as que falharam.
A seguir
Última verificação no commit d3c2586b (2026-08-03)