> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# コードまたはリンクを送信

> パスワードレス認証を開始するために、ユーザーのメールアドレスまたは電話番号にワンタイムコードまたはマジックリンクを送信します。

<div id="endpoint">
  ## エンドポイント
</div>

`POST /passwordless/start`

パスワードレス接続では、ユーザーがパスワードを覚えておく必要はありません。代わりに、ログインのたびに、メールや SMS で送信されるワンタイムコードなどの別の方法で本人確認を行います。

[パスワードレス認証](https://auth0.com/docs/authenticate/passwordless)には、次の 3 つの方法があります。

* メールで確認コードを送信する。
* メールでリンクを送信する。
* SMS で確認コードを送信する。

<div id="remarks">
  ### 備考
</div>

* メールまたはSMSで確認コードを送信した場合は、コードを受け取った後、`username` に `email` または `phone_number` を、`password` に確認コードを指定して、[/passwordless/verify エンドポイント](/passwordless/authenticate-user)を使用してユーザーを認証する必要があります。
* このエンドポイントはクライアント側から呼び出すことを想定して設計されており、\[レート制限][https://auth0.com/docs/troubleshoot/customer-support/operational-policies/rate-limit-policy](https://auth0.com/docs/troubleshoot/customer-support/operational-policies/rate-limit-policy))の対象です。
* auth0.js のサンプルスクリプトでは、ライブラリのバージョン 8 を使用しています。auth0.js バージョン 7 を使用している場合は、この[リファレンスガイド](/libraries/auth0js/v7)を参照してください。

<div id="error-codes">
  ### エラーコード
</div>

このエンドポイントの完全なエラーコード一覧については、[Errors > POST /passwordless/start](#post-passwordless-start)を参照してください。

<div id="learn-more">
  ### 詳細
</div>

* [Passwordless Authentication](https://auth0.com/docs/authenticate/passwordless)
* [Passwordless Best Practices](https://auth0.com/docs/authenticate/passwordless/best-practices)

<div id="body-parameters">
  ## Body Parameters
</div>

<ParamField body="client_id" type="string" required>
  アプリケーションの`client_id`。
</ParamField>

<ParamField body="client_assertion" type="string">
  アプリケーションの認証情報を用いて署名したアサーションを含むJWTです。アプリケーションの認証方式がPrivate Key JWTの場合に必須です。
</ParamField>

<ParamField body="client_assertion_type" type="string">
  値`urn:ietf:params:oauth:client-assertion-type:jwt-bearer`を使用します。アプリケーションの認証方式がPrivate Key JWTの場合に必須です。
</ParamField>

<ParamField body="client_secret" type="string">
  アプリケーションの`client_secret`。**Regular Web Applicationsのみ**必須です。
</ParamField>

<ParamField body="connection" type="string" required>
  コードまたはリンクをユーザーに送信する方法を指定します。メールで送信する場合は`email`、SMSで送信する場合は`sms`を使用します。

  使用可能な値: `email`, `sms`
</ParamField>

<ParamField body="email" type="string">
  `connection=email`の場合は、ユーザーのメールアドレスを設定します。
</ParamField>

<ParamField body="phone_number" type="string">
  `connection=sms`の場合は、ユーザーの電話番号を設定します。
</ParamField>

<ParamField body="send" type="string">
  リンクを送信する場合は`link`、確認コードを送信する場合は`code`を使用します。nullの場合は、リンクが送信されます。

  使用可能な値: `link`, `code`
</ParamField>

<ParamField body="authParams" type="object">
  `scope`、`state`、`redirect_uri`など、追加したい認証パラメーターです。

  <Expandable title="properties">
    <ParamField body="scope" type="string">
      OAuthスコープ。
    </ParamField>

    <ParamField body="state" type="string">
      リクエストとコールバックの間で状態を保持するためのstateパラメーター。
    </ParamField>
  </Expandable>
</ParamField>

<div id="response-messages">
  ## レスポンスメッセージ
</div>

| ステータス | 説明                         |
| ----- | -------------------------- |
| 200   | コードまたはリンクが正常に送信されました。      |
| 400   | 不正なリクエストです。パラメータが無効です。     |
| 401   | 認証されていません。クライアント認証情報が無効です。 |