メインコンテンツへスキップ
POST
Python

承認

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>
必須

法人確認 (KYB) セッションのUUIDです。APIキーのアプリケーションに属している必要があります。

例:

"33333333-4444-5555-6666-777777777777"

クエリパラメータ

node_id
string

KYBステップのワークフローノード。ワークフローに複数のKYBノードがある場合にのみ必要です。デフォルトでは、Diditはセッション自身のノードを使用します。

ボディ

application/json
locale
string

セッションの移行先となるステップのレスポンスを翻訳するために使用するロケール。

Maximum string length: 10

レスポンス

申告された(または既に申告済みの)関係者。

valid
boolean
next_step
string | null

セッションの現在のステップ。

status
string

企業セッションのステータス。

advanced
boolean

この呼び出しで当事者が申告され、セッションが次に進んだ場合はtrueです。

already_submitted
boolean

当事者が以前の呼び出しで申告済みだった場合はtrueです。

kyb_key_people_status
string
parties
object[]
最終更新日 2026年11月1日