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

SMSにブランド名を表示する

SMSのコードには、Business Consoleで設定したアプリケーションのSMS送信者名が追加料金なしで表示されます。
Acme Bankの認証コードは123456です
特定のコードだけを別の名前で送信するには、options.sms_sender_nameを指定します(1〜30文字。使用できるのは英字、数字、スペース、’ & - !のみで、数字だけの名前は使用できません)。
この規則に合わない名前を指定すると400が返され、コードは送信されません。 WhatsAppのコードは固定のメッセージを使用するため、ブランド名は表示されません。自社の名前で送信するには、Business Consoleで自社のWhatsApp Business番号を接続してください。詳しくは自社の番号からWhatsAppコードを送信するを参照してください。 コードにどの名前が表示されるか、および新しい名前の1日あたりの上限については、ブランド名入りの認証メッセージを参照してください。

プロバイダー障害への対応

電話サービスプロバイダーが一時的に利用できない場合、このエンドポイントは502と、固定の機械可読コードを返します。
このレスポンスは再試行可能として扱ってください。短いバックオフを設け、有効な電話番号やコードの変更をユーザーに求めるのではなく、サービスが一時的に利用できない旨のメッセージを表示してください。

承認

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

受信者の電話番号。E.164形式で、先頭の+と国番号を含めます(例: +14155552671)。番号は検証されたうえでE.164に正規化されます。解析できない番号や無効な番号の場合は、phone_numberフィールドのエラーとともに400が返されます。

Maximum string length: 20
例:

"+14155552671"

options
object

OTP配信のオプション。すべてのフィールドは任意です。

signals
object

エンドユーザーに関するデバイスおよびネットワークの任意のシグナルで、不正利用や自動化されたトラフィックの検出精度を高めるために不正対策レイヤーへ転送されます。すべてのフィールドは任意です。

vendor_data
string

呼び出し側が管理する任意の識別子(社内のユーザーid、メールアドレス、UUIDなど)です。セッションに保存され、送信レスポンス、対応するチェックレスポンス、Webhook、Business Consoleでそのまま返されます。Diditのrequest_idを自社のユーザーレコードと関連付けるために使用してください。

metadata
object | null

セッションに保存される任意の自由形式のJSONオブジェクトです。送信レスポンス、対応するチェックのレスポンス、Webhook、Business Consoleでそのまま返されます。

レスポンス

送信を受け付けました。statusを確認してください。SuccessとRetryはコードが送信中であることを示し、Blockedは不正防止レイヤーが拒否し、認証がすでにDeclinedとして確定済みであることを示します。request_idは永続化されたセッションIDです(Retryの場合も同じIDです)。

request_id
string<uuid>

認証のセッションID。Retryによる送信では、元の送信と同じrequest_idが返されます。このIDはBusiness Consoleに表示され、確定済みのPOST /v3/phone/check/でも再度返され、GET /v3/session/{sessionId}/decision/に渡すことができます。

status
enum<string>

Success:新しい認証にOTPを送信しました。Retry:以前の送信で作成された保留中の認証に対して、OTPを再送信しました。Blocked:不正防止レイヤーが送信を拒否しました。認証は直ちにDeclinedとして確定し、課金は発生しません。

利用可能なオプション:
Success,
Retry,
Blocked
reason
string | null

送信がBlockedとなった理由です(例:repeated_attempts、suspicious、spam)。SuccessおよびRetryの場合はnullです。

vendor_data
string | null

セッションに保存されているvendor_data(最初の送信時のもの)のエコー。

metadata
object | null

セッションに保存されているmetadata(最初の送信時のもの)のエコー。

最終更新日 2026年11月1日