Para deletar do sistema os dados biométricos de um usuário já cadastrado, usa-se a operação delete. Para o corpo desta requisição, basta inserir um objeto do tipo Person, em que o único conteúdo será o CustomID do usuário na qual deseja deletar os dados biométricos. Um exemplo de como ficaria o corpo da requisição pode ser visto abaixo:
{ "Person": { "CustomID": "1234" } }
Para o header da requisição, basta inserir o tipo de conteúdo e sua chave de inscrição, onde há escrito <API-KEY> no exemplo abaixo:
{ 'Content-Type': 'application/json', 'Ocp-Apim-Subscription-Key': '<API-KEY>' }
Por fim, conclua a requisição inserindo a especificação de método DELETE, a URL https://api.biopassid.com/multibiometrics/delete, o corpo e o header da transação, conforme no exemplo abaixo escrito em Python, mas que pode ser verificado em diversas outras linguagens de programação em nossa documentação:
import http.client import json conn = http.client.HTTPSConnection("hml-api.biopassid.com") payload = json.dumps({ "Person": { "CustomID": "1234" } }) headers = { 'Content-Type': 'application/json', 'Ocp-Apim-Subscription-Key': '<API-KEY>' } conn.request("DELETE", "/multibiometrics/delete", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8"))
Ao enviar a requisição, o sistema enviará uma mensagem contendo um código de resposta. Se este código for referente a um erro, como 400 ou 401, verifique se sua chave de inscrição e mensagem JSON foram preenchidos corretamente, conforme os exemplos citados. Caso o código retornado seja 200 (OK), isso significa que a transação foi concluída com sucesso, o usuário foi deletado do banco de dados e você já pode seguir para as próximas requisições.
A mensagem de retorno do sistema para a requisição feita no exemplo pode ser verificada abaixo, sendo composta por um objeto do tipo Person que contém o CustomID informado na requisição do usuário que teve suas informações deletadas da base:
{ "Person": { "CustomID": "1234" } }