メインコンテンツへスキップ
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
entity_type
enum<string>
必須

当事者が個人か企業か。

利用可能なオプション:
person,
company
nationality
string
必須

個人の国籍、または企業の設立国。すべての当事者で必須です。

Maximum string length: 100
full_name
string

人物の氏名。これを送信するか、first_nameとlast_nameを送信してください。

Maximum string length: 255
first_name
string
Maximum string length: 128
last_name
string
Maximum string length: 128
role
enum<string>

当事者が持つ役割。rolesと互換性があり、両方が送信された場合は統合されます。

利用可能なオプション:
director,
non_executive_director,
secretary,
chairman,
ubo,
shareholder,
representative,
founder,
legal_advisor,
authorized_signatory,
trustee,
beneficiary,
settlor,
protector,
company_officer,
investor,
other
roles
enum<string>[]

当事者が持つすべての役割です。個人には少なくとも1つの役割(ここまたはroleで指定)が必要です。

利用可能なオプション:
director,
non_executive_director,
secretary,
chairman,
ubo,
shareholder,
representative,
founder,
legal_advisor,
authorized_signatory,
trustee,
beneficiary,
settlor,
protector,
company_officer,
investor,
other
position
string

人物の役職。

Maximum string length: 128
date_of_birth
string<date> | null
company_name
string

企業当事者の名称。entity_typeがcompanyの場合は必須です。

Maximum string length: 255
registration_number
string

企業当事者の登記番号。

Maximum string length: 100
email
string<email>

認証リンクの送信先です。当事者が検証を完了する必要がある場合は必須です。これはワークフローの役割設定と所有構造のしきい値によって決まります。

ownership_percent
number | null

当事者が保有する会社の持分割合。

phone_number
string
Maximum string length: 32
custom_fields
object

ワークフローで定義された追加フィールド。

skip_verification
boolean
デフォルト:false

この当事者の認証のスキップを申請します。ワークフローの主要人物設定で、当事者の役割にスキップが許可されている場合にのみ受け付けられます。

レスポンス

ドラフトを作成しました。

draft_id
string<uuid>
必須
created_at
string<date-time>
必須
updated_at
string<date-time>
必須
party
object
必須
最終更新日 2026年11月1日