開発者

GET/v3/delete_document/{uuid}

登録プロフィールの削除

データを削除する従来の操作について理解し、その限定的な結果を確認します。

このページの内容
  1. 登録プロフィールを慎重に削除する
  2. データを削除する従来のリクエスト
  3. 返される結果
  4. 削除とその範囲を確認する

登録プロフィールを慎重に削除する

この従来の操作は、アカウントが所有する通信事業者側の本人情報と住所の削除を試みた後、ローカルのプロフィールを削除済みとしてマークします。正しいローカルプロフィールのUUIDを特定するには、次のAPIを使用してください:documents。また、呼び出す前に、次の場所でその内容を確認してください:ポータル。この操作は証明資料だけを削除するものでも、操作を取り消すものでもありません。

データを削除する従来のリクエスト

許可されたIPアドレスから、有効化済みのMultiTEL APIアカウントで認証してください。例では、環境変数に設定した認証情報と架空のデータを使用しています。HTTPレスポンスに加え、JSONの status.code と status.msg も確認してください。

現在のポータルは、この操作を GET で呼び出します。このHTTPメソッドを使用していても、データは変更されます。このURLをリンク、画像、ヘルスチェック、ブラウザーのプリフェッチ、クローラー、自動再試行に使用することは絶対に避けてください。連携を実装する際は、ユーザーが削除を明示的に決定することを必須にしてください。

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/delete_document/$DOCUMENT_UUID"

DOCUMENT_UUID は、作成時に uuid として、またはプロフィールの取得時に id として返されるローカルプロフィールの識別子です。本人情報ID、住所ID、電話番号ではありません。リクエストボディは使用しません。

返される結果

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": []
}

APIコード 404 とメッセージ Failed, Not found は、このアカウントで該当するプロフィールUUIDが見つからなかったことを意味します。200 が返された場合、ハンドラーが完了レスポンスを返す段階に到達したことを意味しますが、通信事業者が本人情報や住所を削除したことや、ローカルデータベースの更新が成功したことの証明にはなりません。

削除とその範囲を確認する

現在のハンドラーは、通信事業者側の削除やローカル更新の結果を確認しません。成功が返された後は、有効なプロフィールを返す documents の結果に該当プロフィールが含まれていないこと、および get_document で見つからないという結果が返されることを確認してください。これらの確認で分かるのは、ローカルで表示・取得できるかどうかだけです。上流の通信事業者側で削除されたことの証明にはなりません。

このエンドポイントは、汎用的な個人データ消去APIではありません。アップロード済みファイル、証明資料、補足書類、ログ、バックアップ、その他の保持されている記録が削除されたことを確認するものではありません。上流側での削除の確認やデータ消去の依頼については、サポートにお問い合わせください。一部のみ処理された結果の確認に代えて、削除を繰り返し呼び出さないでください。