対面での署名 - Box Dev Docs

リクエスト送信者と署名者が一緒にいて、署名者がリクエスト送信者のデバイスでリクエストを完了する必要がある場合は、is_in_personをtrueに設定します。これは、リクエストの作成時に署名者に対して設定します。さらに、embed_url_external_user_idを設定すると、レスポンスにembed_urlとiframeable_embed_urlが含まれます。このURLをアプリで開くことで、署名セッションが開始されます。また、このURLはアプリに埋め込むこともできます。詳細については、署名クライアントの埋め込みを参照してください。

各署名者が順番に署名する対面署名

対面署名のリクエストの作成

curl -i -X POST "https://api.box.com/2.0/sign_requests" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H "content-type: application/json" \
     -d '{
       "template_id": "ee9a689e-96b6-4076-92a0-b9b765eb09ca",
       "parent_folder": {
         "type": "folder",
         "id": "0987654321"
       },
       "signers": [
         {
           "email": "signer-a@example.com",
           "role": "signer",
           "is_in_person": true,
           "embed_url_external_user_id": "1234"
         },
         {
           "email": "signer-b@example.com",
           "role": "signer",
           "is_in_person": true
         }
       ]
     }'

最初に署名する対面署名者にembed_urlとiframeable_embed_urlが提供されます。同じセッションの後続の対面署名者については、固有のembed_url_external_user_idは必要ありません。

1つのセッションで複数名が署名する場合

最初の対面署名者が署名を完了した後、インターフェースが次の対面署名者用に切り替わります。全員の署名が完了したドキュメントは、各署名者にメールで送信されます。

Box Signクライアントでの最初の対面署名者

最初の署名者が署名を完了した後の、2番目の対面署名者

最終更新日 2026年10月14日