Eliminare un utente
Rimuove l’utente autenticato nell’ambito di rete del suo token di accesso utente.
Header#
3Parametri del percorso#
1Corpo della richiesta#
0Risposta#
6Prima di eliminare un utente#
- Ottieni il token di accesso utente del cliente tramite il flusso di autenticazione.
- Imposta l’ID utente del percorso con l’UUID del cliente autenticato. Un cliente può eliminare solo il proprio utente.
- Conferma che il cliente intenda rimuovere il proprio account dalla rete associata a quel token.
Comprendere l’ambito dell’eliminazione#
Con un token limitato a una rete, l’eliminazione rimuove l’appartenenza dell’utente e i suoi indirizzi in quella rete e richiede la rimozione delle sue carte nella stessa rete. Non implica l’eliminazione da tutte le reti DEUNA. Un token di account con ambito generale DEUNA rimuove anche l’account e le sue appartenenze alle reti. Un’eliminazione riuscita rimuove le sessioni attive dell’utente.
Non considerare questa operazione una conferma della cancellazione di tutti i dati storici dei pagamenti o di tutti i dati personali. Conferma l’ambito richiesto per la rimozione dell’account e dei dati con il tuo Technical Account Manager DEUNA prima di creare un flusso di chiusura dell’account.
Inviare la richiesta di eliminazione#
Usa l’URL di base sandbox qui sotto per i test e https://api.deuna.io per la produzione. Invia il token Bearer del cliente nell’header Authorization. L’endpoint non prevede parametri di query né un corpo della richiesta.
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))
}Verifica il risultato#
Una richiesta riuscita restituisce HTTP 204 No Content con un corpo vuoto. Cancella la sessione locale del cliente e mostra l’esperienza senza accesso effettuato. Non interpretare la risposta come JSON e non attendere un webhook di pagamento per confermare questa operazione.
Gestire errori e risultati incerti#
HTTP 400 può indicare che l’utente nel percorso è diverso dall’utente del token. HTTP 401 significa che il token utente non può autorizzare la richiesta; HTTP 404 significa che il record richiesto non è stato trovato. Correggi la richiesta o l’autenticazione prima di riprovare.
Un timeout o un errore del server può verificarsi dopo che parte dell’eliminazione ha già avuto effetto. HTTP 503 può verificarsi durante la pulizia delle sessioni dopo l’eliminazione. Non presumere che un nuovo tentativo restituisca la stessa risposta e non ripetere automaticamente la richiesta. Verifica lo stato dell’account con il supporto DEUNA quando l’esito è incerto. Per questa operazione non è definito un contratto di chiave di idempotenza.
Vedi codici di risposta e risoluzione dei problemi per indicazioni generali sulla gestione degli errori.
Questa pagina è stata utile?