Salesforce

Como utilizar a API para criação assíncrona de solicitações

« Go Back
Information
Como utilizar a API para criação assíncrona de solicitações
UUID-c35a2967-4869-e091-b957-f3819f20d55e
Article Content

Você pode chamar o OneTrust assincronamente de um formulário web publicado ou aplicativo externo para criar dinamicamente uma solicitação que aparecerá na tela Configuração do formulário da Web.

Nota

Esta documentação usa a ferramenta Carteiro para testar integrações de API.

Para copiar a URL da API

  1. No menu Solicitações dos titulares de dados, selecione Formulários da Web. A tela Modelos de Formulários da Web é exibida.

  2. Clique em um formulário publicado na web. A tela Personalização de formulários da Web é exibida.

    Nota

    Este recurso é compatível apenas com formulários da Web publicados. Para obter mais informações sobre a criação de novos formulários da Web, consulte Criar um Formulário web.

  3. Vá para a guia Integrar e clique na guia API.

    integrate-api-tab.png
  4. Clique no botão Copiar URL no bloco Seu URL da API.

    your-api-url.png
  5. No Postman, selecione POST no campo end-point.

  6. Cole o Seu URL da API no campo URL.

    post-url-postman.png

Para copiar o Token API

  1. Na guia API no OneTrust e clique no botão Copiar token no bloco Seu Token da API.

    your-api-token.png
  2. No Postman, clique na guia Cabeçalhos.

  3. Insira o accessToken no campo Chave.

  4. Cole o token API do OneTrust no campo Value.

    access-token-postman.png

Para copiar a carga esperada

  1. Na guia API no OneTrust, clique no botão Copiar carga esperada no bloco Carga esperada.

    Nota

    Quaisquer edições feitas nos campos de formulários da Web serão atualizadas dinamicamente na carga útil esperada.

    expected-payload.png
  2. No Postman, clique na guia Body.

  3. Habilite raw como o tipo de visualização.

    Nota

    Certifique-se de que JSON é o tipo de arquivo selecionado.

  4. Cole a carga esperada no corpo.

    Dica

    Você pode adicionar os detalhes de uma solicitação editando a carga útil. Remova quaisquer parâmetros adicionais que você não deseja enviar para criar a solicitação ou tenha valores nulos (por exemplo, sem anexos). A chamada não enviará com valores de parâmetro nulos.

    body-payload-postman.png
  5. Clique no botão Enviar.

  6. Verifique se a chamada foi enviada verificando o código de status. Se executado corretamente, ele deve retornar um valor requestTraceId.

    requesttraceid-postman.png
  7. Copie o requestTraceId.

Para verificar a solicitação no OneTrust

  1. Crie outra chamada no Postman usando o end-point status da solicitação GET do Trace ID: GET /api/datasubject/v2/requestqueues/status/{traceId}

  2. Anexe o requestTraceID recém-criado ao final do endpoint.

    requesttraceid-url-get.png
  3. Na guia Cabeçalho , digite outra tecla API.

  4. Clique no botão Enviar.

  5. Se a chamada for bem-sucedida, ela retornará um Creationstatus:SUCCESS e um novo requestReId.

    requestReID2.png
  6. Retorne ao OneTrust para ver se a solicitação recém-criada aparece na Fila de solicitações com o requestReId correspondente.

 
Article Visibility
7,600
Translation
Portuguese (Brazil)
Not Checked

Powered by