未使用のアップロード参照を選ぶ
このエンドポイントは、ご利用のアカウントに属するアップロード参照レコードを削除します。その参照が次の用途に不要になったと確信できる場合にのみ使用してください：証明資料の添付または補足書類の添付。登録用の本人情報や住所は削除しません。
外部ファイルIDの取得元は、元のアップロード時のレスポンスまたは利用可能なアップロードの一覧です。ハンドラーはまず、ご利用のアカウントに対してそのIDを検索し、見つからない場合は従来のプロバイダーIDによる検索を行います。新しい連携では、返された外部参照をそのまま使用してください。リクエスト本文は不要です。
明示的な操作で削除をリクエストする
有効化されたMultiTEL APIアカウントを使用し、そのアカウントに設定された認証情報とIP制限に従ってHTTPSで接続してください。アプリケーションがこれを明示的な変更操作として扱うよう、POSTを使用してください：
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdef現在のハンドラーはHTTPメソッドを制限していないため、GETリクエストでも削除処理が実行される可能性があります。このURLを、通常のクリック可能なリンク、画像、ブックマーク、プレビュー、プリフェッチの対象として公開しないでください。アプリケーションでは明示的な削除操作を必須とし、自動的に再試行しないでください。
結果の意味と限界を理解する
HTTPの結果と、JSONのstatus.codeの両方を確認してください。通常の成功レスポンスは次のとおりです：
{
"status": {"code": 200, "msg": "Success"},
"response": []
}APIコード404とFailed, Not foundが返された場合、どちらの検索でも、このアカウントに一致する参照が見つからなかったことを意味します。そのため、同じ削除を繰り返すと404が返される場合があります。パスの値の前後にある空白は除去されます。この処理では、参照が有効期限内であることや、他のステップで使用されていないことは確認されないため、削除する前にワークフローを確認してください。
ハンドラーはデータベースからの削除を試みた後、その削除が成功したかどうかを確認せずに成功を報告します。レスポンスは報告された処理結果として扱い、消去を独立して証明するものとは見なさないでください。APIで作成された有効期限内の参照がget_encrypted_filesに表示されていた場合、その一覧を使って引き続き表示されるかを確認できます。ただし、一覧に表示されない理由が有効期限切れである可能性もあります。
この削除はデータの完全消去ではありません
ハンドラーはアップロード参照テーブルに対して削除処理を実行します。保存された文書内容の行、ローカルにアップロードされたファイル、添付済みの証明資料、本人情報、補足書類、プロバイダーが保有するコピーを明示的に削除することはありません。データベースの連鎖削除とデータ保持の動作は未検証です。この操作について、本人確認書類のすべてのコピーを削除するもの、または包括的な消去要求を満たすものとユーザーに説明しないでください。
ローカルの参照を削除すると、その参照を必要とする後続の添付ステップが失敗する可能性があります。完了済みの添付結果は保持し、提出済みの登録情報を変更する際は、該当する本人情報または証明資料の管理ワークフローを使用してください。