メインコンテンツへスキップ
POST
cURL
同じ組織内で、検証トラフィック、認証情報、ブランディング、レポートを分けて管理したい場合は、このエンドポイントを使用します。 特に、顧客ごとに1つのアプリケーションを作成するリセラーに役立ちます。また、自社で複数のプロダクト、ブランド、リージョン、ステージング環境と本番環境、ユースケースを運用していて、それぞれが同じAPIキーやアプリケーション単位の設定を共有すべきでない場合にも適しています。
Auth APIのすべてのエンドポイントはhttps://apx.didit.me/auth/v2を使用します。セッションやワークフローなどのhttps://verification.didit.me/v3/...エンドポイントを呼び出す際は、返されたapi_keyをx-api-keyとして使用してください。

承認

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です。GET /organizations/me/で確認できます。

例:

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

ボディ

application/json

すべてのフィールドは任意です。ボディを省略すると、デフォルト名"<organization name> App"で、公開URLが設定されていないアプリケーションが作成されます。

すべてのフィールドは任意です。空のボディを送信すると、デフォルト名のアプリケーションが作成されます。

name
string

アプリケーションの表示名。デフォルトは"<organization name> App"です。

例:

"Acme Customer App"

website_url
string

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

例:

"https://acme.example"

redirect_uris
string[]

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

例:
terms_url
string

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

例:

"https://acme.example/terms"

privacy_url
string

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

例:

"https://acme.example/privacy"

description
string

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

レスポンス

アプリケーションが作成されました。レスポンスには有効期間の長いapi_keyが含まれます。今すぐ保存し、すべてのhttps://verification.didit.me/v3/...呼び出しでx-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日