...
Note que os acompanhados por "*", são obrigatórios;
Integration-Action: ação a ser realizada na API de integração. São suportadas as ações:
...
upsert: possui dois comportamentos, podendo atuar como atualização ou inserção. O que determina o comportamento é o conteúdo informado no header Integration-Filter. Se o registro informado já existir no CRM, é realizada uma atualização completa do registro presente no CRM, substituindo todo o conteúdo presente no CRM pelo conteúdo enviado na requisição. Se o ID não estiver presente no CRM, é feita uma inserção do conteúdo enviado na requisição;
Integration-Service: serviço responsável pela entidade. Por exemplo: customer;
Integration-Resource: recurso para requisição. Por exemplo: customers-integration;
Integration-Version: versão do contrato da API de integração. Deve ser utilizado a versão mais recente disponível de cada API para ter acesso à atributos personalizados. Por exemplo: v1;
Integration-Filter: usado nas ações de update e upsert como identificador do registro a ser atualizado ou quando a consulta realizada for um GET, atua como filtro de registros, sendo suportado o formato RestQuery para a filtragem. Para o exemplo de criação de cliente com a ação create, não é suportado o uso deste header:
KEY | VALUE |
Integration-Version | v4 |
Integration-Service | customer |
Integration-Resource | customers-integration |
Integration-Action | create |
Integration-Response: define o nível de resposta. Existem dois níveis de retorno de requisição:
Caso não seja informado o header Integration-Response na requisição, o retorno será equivalente ao nível minimum.
...