Remover um perfil de cadastro de forma deliberada
Esta operação legada tenta excluir a identidade e o endereço da conta na operadora e, em seguida, marca o perfil local como excluído. Identifique o UUID correto do perfil local com documents e confira o perfil no portal antes de chamar a operação. Ela não se limita à remoção de comprovantes nem é uma operação de desfazer.
Requisição legada destrutiva
Autentique-se com sua conta habilitada da API MultiTEL a partir de um endereço IP permitido. Os exemplos usam credenciais em variáveis de ambiente e dados fictícios. Leia os campos status.code e status.msg do JSON, além da resposta HTTP.
O portal atual chama esta operação usando GET. Apesar do método HTTP, ela altera dados. Nunca use a URL em um link, imagem, verificação de integridade, pré-carregamento do navegador, rastreador ou nova tentativa automática. Exija uma decisão explícita de exclusão por parte do usuário na sua integração.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/delete_document/$DOCUMENT_UUID"DOCUMENT_UUID é o identificador do perfil local retornado como uuid durante a criação ou como id durante a consulta do perfil. Não é o ID da identidade, o ID do endereço nem um número de telefone. Não se usa corpo de requisição.
Resultado informado
{
"status": {
"code": 200,
"msg": "Success"
},
"response": []
}O código 404 da API com a mensagem Failed, Not found significa que o UUID do perfil não foi encontrado para esta conta. Um código 200 informado significa que o manipulador chegou à resposta de conclusão; isso não comprova que a operadora excluiu a identidade e o endereço nem que a atualização do banco de dados local foi bem-sucedida.
Verificar a remoção e seu alcance
O manipulador atual não verifica os resultados da exclusão na operadora nem da atualização local. Após uma indicação de sucesso, confirme que o perfil não aparece entre os resultados ativos de documents e que a consulta retorna um resultado de não encontrado em get_document. Essas verificações confirmam apenas a visibilidade local. Elas não comprovam a exclusão em uma operadora a montante.
Este endpoint não é uma API de uso geral para apagamento de dados pessoais. Ele não comprova a exclusão de arquivos enviados, comprovantes, documentos de apoio, registros de log, cópias de segurança ou outros registros retidos. Para confirmar a remoção na operadora a montante ou solicitar o apagamento de dados, entre em contato com o suporte. Não chame a operação de exclusão repetidamente em substituição à verificação de um resultado parcial.