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

# クイックスタート

> ファイル、保存先フォルダ、署名者のメールアドレスを指定して、初めてのBox Signリクエストを送信します。

<Note>
  このチュートリアルでは、基本のリクエストを作成します。作成時のオプションの詳細については、[Box Signリクエストの作成](/guides/box-sign/create-sign-request)を参照してください。
</Note>

Boxに保存されているドキュメントがあり、署名をもらうために顧客に送信することを想像してみてください。少なくとも、アプリでは、署名対象のドキュメント、署名済みドキュメントの保存先、署名者のメールアドレスを認識する必要があります。

## 署名リクエストの作成

署名リクエストの作成には、[Box Sign API](/reference/post-sign-requests)または使用可能ないずれかの[SDK](/guides/tooling/sdks)を使用します。次の例を参照してください。

<CodeGroup>
  ```sh cURL theme={null}
  curl --location 'https://api.box.com/2.0/sign_requests' \
      --header 'Content-Type: application/json' \
      --header 'Authorization: Bearer <access token>' \
      --data-raw '{
        "is_document_preparation_needed": true,
        "parent_folder": {
          "id": "234102987614",
          "type": "folder"
        },
        "source_files": [
          {
            "id": "1355143830404",
            "type": "file"
          }
        ],
        "signers": [
          {
            "email": "signer@example.com",
            "role": "signer"
          }
        ]
      }'
  ```

  ```python Python v10 theme={null}
  sign_request = client.sign_requests.create_sign_request(
      [SignRequestCreateSigner(email=signer_email)],
      source_files=[FileBase(id=document_id)],
      parent_folder=FolderMini(id=destination_folder_id),
      is_document_preparation_needed=True,
  )

  if sign_request.prepare_url is not None:
      print(sign_request.prepare_url)
  ```
</CodeGroup>

これの結果、ドキュメント準備のURL (簡略化されています) を含む署名リクエストが作成されます。

<CodeGroup>
  ```json cURL theme={null}
  {
    "is_document_preparation_needed": true,
    "signers": [
      {
        "email": "requester@example.com",
        "role": "final_copy_reader",
      },
      {
        "email": "signer@example.com",
        "role": "signer",
      }
    ],
    "id": "348decab-48a8-4f2c-9436-8967afebf7bb",
    "prepare_url": "https://app.box.com/sign/document/xyz-abc-123/.../prepare_doc/",
    "source_files": [
      {
        "id": "1355143830404",
        "type": "file",
      }
    ],
    "parent_folder": {
      "id": "234102987614",
      "type": "folder",
    },
    "name": "Simple-PDF.pdf",
    "type": "sign-request",
    "status": "converting",
    "sign_files": {
      "files": [
        {
          "id": "1381301154812",
          "type": "file",
        }
      ],
      "is_ready_for_download": true
    },
    "template_id": null
  }
  ```

  ```yaml theme={null}
  Simple sign request with prep: xyz-abc-123
    Status: converting
    Signers: signer@example.com
  Prepare url: https://app.box.com/sign/document/xyz-abc-123/.../prepare_doc/
  ```
</CodeGroup>

## 署名リクエストのステータスの確認

署名リクエストの作成は非同期処理であり、エラーが発生する可能性があります。アプリケーションでは、処理を進める前にリクエストのステータスを確認し、エラーがあれば処理する必要があります。

署名リクエストのステータスを以下に示します。

<Frame>
  <img src="https://mintcdn.com/box/isjmNzuG7xfW57th/images/guides/box-sign/basic-sign-flow.png?fit=max&auto=format&n=isjmNzuG7xfW57th&q=85&s=46600c923146e8232c3016b42a6087da" alt="署名のフロー" width="1920" height="1080" data-path="images/guides/box-sign/basic-sign-flow.png" />
</Frame>

ステータスの詳細なリストについては、[Box Signリクエストのステータス](/guides/box-sign/request-status)を参照してください。

## ドキュメントの準備

この例では、PDFに署名していますが、Box Signエンジンは、署名フィールドやその他の入力データの配置場所を認識しません。そのため、`is_document_preparation_needed`フラグを使用しました。

準備のURLが存在する場合、アプリケーションはそのURLをブラウザで開きます。そこで、リクエスト送信者は、署名者がドキュメントでの作業を完了するために必要な署名フィールドやその他の入力データを追加できます。

ドキュメントが準備できたら、リクエスト送信者は署名リクエストを署名者に送信できます。

この準備手順は必須ではありません。詳細については、[ドキュメントの種類][technical-use-cases]を参照してください。

## 署名リクエストの完了

署名者には、署名リクエストへのリンクが記載されたメールがBoxから届きます。署名者はリンクを選択するとドキュメントに署名できます。

処理が完了すると、メタデータを含む署名ログと署名済みドキュメントの両方が保存先フォルダに格納されます。

これで、最初の署名リクエストを正常に作成できました。

<Note>
  以上は、Box Signでの基本の作成フローです。作成時のオプションの詳細については、[Box Signリクエストの作成](/guides/box-sign/create-sign-request)を参照してください。ドキュメントの種類とその他のシナリオについては、[ドキュメントの種類](/guides/box-sign/document-types)を参照してください。
</Note>

[technical-use-cases]: /guides/box-sign/document-types