ユーザーの削除
ユーザーアクセストークンのネットワーク範囲内で、認証済みユーザーを削除します。
ヘッダー#
3パスパラメーター#
1リクエスト本文#
0レスポンス#
6ユーザーを削除する前に#
- 顧客のユーザーアクセストークンは、次の手順で取得します: 認証フロー.
- パスのユーザーIDには、認証済み顧客のUUIDを指定します。顧客は自分自身のユーザーのみ削除できます。
- 顧客が、そのトークンに関連付けられたネットワークからアカウントを削除する意思を確認します。
削除の範囲を理解する#
ネットワークに限定されたトークンの場合、削除操作はそのネットワーク内のユーザーの所属と住所を削除し、同じネットワーク内のカードの削除を要求します。すべてのDEUNAネットワークからの削除を意味するものではありません。DEUNA全体を対象とするアカウントトークンの場合は、アカウントとネットワークへの所属も削除します。削除が成功すると、ユーザーの有効なセッションも削除されます。
この操作を、すべての過去の決済記録やすべての個人データが消去されたという確認として扱わないでください。アカウントの閉鎖フローを構築する前に、必要なアカウントとデータの削除範囲をDEUNAのTechnical Account Managerに確認してください。
削除リクエストを送信する#
テストには以下のサンドボックスのベースURLを使用し、本番環境には次を使用します: https://api.deuna.io 。顧客のBearerトークンをAuthorizationヘッダーで送信します。このエンドポイントにクエリパラメーターやリクエスト本文はありません。
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))
}結果を確認する#
リクエストが成功すると、空の本文とともにHTTP 204 No Contentが返されます。顧客のローカルセッションを消去し、サインアウトした画面に戻します。レスポンスをJSONとして解析したり、この操作の確認のために決済Webhookを待ったりしないでください。
エラーと結果が不明な場合に対処する#
HTTP 400は、パスのユーザーとトークンのユーザーが異なる場合に返されることがあります。HTTP 401はユーザートークンでリクエストを承認できないことを、HTTP 404は要求したレコードが見つからないことを意味します。再試行する前にリクエストまたは認証を修正してください。
削除の一部が反映された後に、タイムアウトやサーバーエラーが発生することがあります。削除後のセッションのクリーンアップ中にHTTP 503が発生することもあります。再試行で同じレスポンスが返ると想定したり、リクエストを自動的に繰り返したりしないでください。結果が不明な場合は、DEUNAサポートにアカウントの状態を確認してください。この操作には冪等性キーの契約は定義されていません。
参照 レスポンスコードとトラブルシューティング で、一般的なエラー処理を確認してください。
このページは役に立ちましたか?