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

承認

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

ボディ

application/json
vendor_data
string
必須

このトークンの対象となるエンドユーザーに対するお客様の内部識別子です。このトークンで送信されるすべての取引の主体として強制的に適用されます。

例:

"user-042"

ttl_seconds
integer
デフォルト:900

トークンの有効期間(秒)。デフォルトは900(15分)、最大は86400(24時間)です。

必須範囲: x <= 86400
max_uses
integer | null

このトークンで許可される送信成功の最大回数です。省略するかnullにすると、TTL内で無制限に使用できます。

レスポンス

発行されたトークンです。sdk_tokenをアプリに渡してください。このトークンはexpires_atまで、X-Transaction-Tokenヘッダーを介してデバイス向けの/v1/transactions/エンドポイントを認証します。

sdk_token
string

SDKに渡すスコープ付きの取引トークンです。

expires_at
string<date-time>

トークンが受け付けられなくなる日時。

最終更新日 2026年11月1日