Excluir usuário
Remove o usuário autenticado dentro do escopo de rede do seu token de acesso de usuário.
Headers#
3Parâmetros de rota#
1Corpo da solicitação#
0Resposta#
6Antes de excluir um usuário#
- Obtenha o token de acesso de usuário do cliente pelo fluxo de autenticação.
- Defina o ID de usuário da rota como o UUID do cliente autenticado. Um cliente só pode excluir seu próprio usuário.
- Confirme que o cliente deseja remover sua conta da rede associada a esse token.
Entenda o escopo da exclusão#
Com um token restrito a uma rede, a exclusão remove a associação do usuário e seus endereços nessa rede e solicita a remoção dos seus cartões na mesma rede. Isso não implica a exclusão de todas as redes da DEUNA. Um token de conta com escopo geral da DEUNA também remove a conta e suas associações de rede. Uma exclusão bem-sucedida remove as sessões ativas do usuário.
Não interprete esta operação como confirmação de que todos os registros históricos de pagamentos ou todos os dados pessoais foram apagados. Confirme o escopo necessário de remoção de conta e dados com seu Technical Account Manager da DEUNA antes de criar um fluxo de encerramento de conta.
Envie a solicitação de exclusão#
Use a URL base de sandbox abaixo para testes e https://api.deuna.io para produção. Envie o token Bearer do cliente no cabeçalho Authorization. O endpoint não tem parâmetros de consulta nem corpo de solicitação.
curl --request DELETE \
--url 'https://api.sandbox.deuna.io/users/USER_ID' \
--header 'Authorization: Bearer USER_ACCESS_TOKEN'const response = await fetch("https://api.sandbox.deuna.io/users/USER_ID", {
method: "DELETE",
headers: {
"Authorization": "Bearer USER_ACCESS_TOKEN"
}
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();import requests
response = requests.request(
"DELETE",
"https://api.sandbox.deuna.io/users/USER_ID",
headers={
"Authorization": "Bearer USER_ACCESS_TOKEN"
},
)
response.raise_for_status()
data = response.json()<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sandbox.deuna.io/users/USER_ID",
CURLOPT_CUSTOMREQUEST => "DELETE",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer USER_ACCESS_TOKEN"
]
]);
$response = curl_exec($curl);
curl_close($curl);import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Example {
public static void main(String[] args) throws Exception {
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.sandbox.deuna.io/users/USER_ID"))
.header("Authorization", "Bearer USER_ACCESS_TOKEN")
.method("DELETE", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient().send(
request, HttpResponse.BodyHandlers.ofString()
);
System.out.println(response.body());
}
}package main
import (
"fmt"
"io"
"net/http"
)
func main() {
request, err := http.NewRequest("DELETE", "https://api.sandbox.deuna.io/users/USER_ID", nil)
if err != nil { panic(err) }
request.Header.Set("Authorization", "Bearer USER_ACCESS_TOKEN")
response, err := http.DefaultClient.Do(request)
if err != nil { panic(err) }
defer response.Body.Close()
body, _ := io.ReadAll(response.Body)
fmt.Println(string(body))
}Verifique o resultado#
Uma solicitação bem-sucedida retorna HTTP 204 No Content com corpo vazio. Limpe a sessão local do cliente e apresente a experiência sem sessão iniciada. Não interprete a resposta como JSON nem aguarde um webhook de pagamento para confirmar esta operação.
Trate erros e resultados incertos#
HTTP 400 pode indicar que o usuário da rota é diferente do usuário do token. HTTP 401 significa que o token de usuário não pode autorizar a solicitação; HTTP 404 significa que o registro solicitado não foi encontrado. Corrija a solicitação ou a autenticação antes de tentar novamente.
Um tempo limite ou erro do servidor pode ocorrer depois que parte da exclusão já teve efeito. HTTP 503 pode ocorrer durante a limpeza das sessões após a exclusão. Não presuma que uma nova tentativa retornará a mesma resposta nem repita a solicitação automaticamente. Verifique o estado da conta com o suporte da DEUNA quando o resultado for incerto. Não há contrato de chave de idempotência definido para esta operação.
Veja códigos de resposta e solução de problemas para orientações gerais sobre tratamento de erros.
Esta página foi útil?