メインコンテンツへスキップ
PATCH
curl
extra_filesの事前署名付きリンクには有効期限があります。後でファイルが必要になったときは、セッションの判定から新しいリンクを取得してください。書類から抽出されたデータを修正したい場合は、代わりにセッションデータの更新を使用してください。

承認

x-api-key
string
header
必須

お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys

パスパラメータ

sessionId
string<uuid>
必須

ファイルを追加するユーザー認証 (KYC) セッションのUUID (POST /v3/session/が返すsession_id) です。法人確認 (KYB) セッションのIDを指定すると404が返されます。

例:

"11111111-2222-3333-4444-555555555555"

ボディ

multipart/form-data
file
file
必須

画像またはPDFです。使用できる拡張子はjpg、jpeg、png、webp、tiff、pdfです。アップロード時点で最大15MBです。その後ファイルは圧縮され、それでも2MB(2,097,152バイト)を超える場合は400で拒否されます。空のファイルは拒否されます。

model_type
enum<string>
必須

kycはファイルを本人確認の結果に、poaは住所証明の結果に追加します。

利用可能なオプション:
kyc,
poa
例:

"kyc"

file_password
string

暗号化されたPDFのパスワード。パスワードがない場合や誤っている場合、暗号化されたPDFは400を返します。

レスポンス

ファイルが追加されました。新しいファイルを含め、その結果のすべての追加ファイルを返します。

extra_files
(string<uri> | null)[]
必須

model_typeで指定された結果のすべての追加ファイルへの有効期間の短い署名付きリンク(古い順)。media: readを持たないスコープ付きAPIキーでは、各リンクはnullです。後から新しいリンクを取得するには、セッションの判定から読み取ってください。

最終更新日 2026年11月1日