メインコンテンツへスキップ
GET
cURL

承認

Authorization
string
header
必須

POST /programmatic/login/またはPOST /programmatic/verify-email/から返される、RS256で署名されたJWTのaccess_token。Authorization: Bearer <access_token>として送信します。デフォルトの有効期間は86400秒(24時間)です。このトークンはapx.didit.me/auth/v2のアカウント管理エンドポイントに対してのみ有効です。認証API(verification.didit.me/v3)では、代わりに長期間有効なapi_keyをx-api-keyとして使用します。

パスパラメータ

org_id
string<uuid>
必須

アプリケーションを所有する組織のUUIDです。

例:

"a1b2c3d4-5678-90ab-cdef-111111111111"

app_id
string<uuid>
必須

認証情報を取得するアプリケーションのUUIDです。

例:

"b2c3d4e5-6789-01bc-defg-222222222222"

レスポンス

client_idとapi_keyを含むアプリケーションレコード。

アプリケーションの完全なレコード。uuid、client_id、api_keyは作成後に変更されることはありません。

uuid
string<uuid>

アプリケーションのUUID。以降の呼び出しで{app_id}として使用します。

例:

"b2c3d4e5-6789-01bc-defg-222222222222"

name
string

Diditコンソールに表示されるアプリケーションの表示名。

例:

"Acme Production App"

client_id
string

公開クライアント識別子で、OAuth形式のフローに埋め込んでも安全です。

例:

"S9LIYGSoWNuGMLHsvEt9dQ"

api_key
string

長期間有効なシークレット(client_secretとも呼ばれます)。https://verification.didit.me/v3/...へのすべての呼び出し(セッション、ワークフロー、AMLなど)でx-api-keyヘッダーとして使用します。認証情報として扱い、クライアント側には決して公開しないでください。新しいキーはsk_live_(本番アプリケーション)またはsk_test_(サンドボックスアプリケーション)で始まり、その後に43文字のURLセーフな文字(英字、数字、-、_)が続きます。この形式より前に作成されたキーにはプレフィックスがなく、変更なしで引き続き使用できます。アカウントを復旧してから72時間は、一覧取得、取得、更新でキーの代わりに空文字列が返されます。

例:

"sk_live_example_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

website_url
string | null

このアプリケーションに関連付けられたWebサイトまたはアプリのURL。

例:

"https://acme.example"

redirect_uris
string[]

OAuth形式および認証リダイレクトフローで許可されるリダイレクトURIです。

例:
terms_url
string | null

認証フローに表示される利用規約のURL。

例:

"https://acme.example/terms"

privacy_url
string | null

検証フローに表示されるプライバシーポリシーのURL。

例:

"https://acme.example/privacy"

description
string | null

アプリケーションの内部説明(エンドユーザーには表示されません)。

created_at
string<date-time>
例:

"2025-06-01T10:00:00Z"

products
object[]
read-only

アプリケーションのプロダクト。常に3つすべてが、identity、transactions、authenticationの順に含まれます。新しいアプリケーションでは、identityがすべてのモジュールをオンにした状態で有効になり、transactionsとauthenticationは無効です。読み取り専用です。作成または更新のボディに含まれるproductsキーは無視されます。

例:
最終更新日 2026年11月1日