コンテンツまでスキップ
日本語
クラウドサインはこちら
  • 検索フィールドが空なので、候補はありません。

Web APIのアップデートについて

 

これまでの Web API アップデート

2026-09-08

  1. 入力項目（ウィジェット）の横幅を明示的に指定できるよう、フリーテキストの横幅指定を受け付けられるようにしました。
    • 対象のエンドポイント
    • POST:/documents/{documentID}/files/{fileID}/widgets

      PUT:/documents/{documentID}/files/{fileID}/widgets/{widgetID}
  2. 装飾を含まない入力項目の幅・高さを取得できるよう、documentModel > files > widgets にパラメータ「inner_width」「inner_height」を追加しました。
    • 対象のエンドポイント
    • POST:/documents

      GET:/documents

      GET:/documents/{documentID}

      PUT:/documents/{documentID}

      POST:/documents/{documentID}

      PUT:/documents/{documentID}/decline

      POST:/documents/{documentID}/files

      DELETE:/documents/{documentID}/files/{fileID}

      POST:/documents/{documentID}/participants

      PUT:/documents/{documentID}/participants/{participantID}

      DELETE:/documents/{documentID}/participants/{participantID}

      POST:/documents/{documentID}/files/{fileID}/widgets

      PUT:/documents/{documentID}/files/{fileID}/widgets/{widgetID}

      DELETE:/documents/{documentID}/files/{fileID}/widgets/{widgetID}

      POST:/documents/{documentID}/reportees

      PUT:/documents/{documentID}/reportees/{reporteeID}

      DELETE:/documents/{documentID}/reportees/{reporteeID}

      POST:/documents/{documentID}/attachments

      PUT:/documents/{documentID}/attachments/{attachmentID}

      DELETE:/documents/{documentID}/attachments/{attachmentID}

      GET:/team_documents

      GET:/cabinet_documents

2026-08-04

WebAPIで並列署名が利用できるよう、パラメータ「group_type」「group_id」を追加しました。

2026-07-16

  • Web APIで使用するクライアントIDを保有するメンバーを、管理者が確認できるようになりました。
  • メンバーが保有するクライアントIDを、管理者が削除できるようになりました。
  • クライアントIDの発行者を、メンバー自身と管理者から選択できるようになりました。

2026-06-30

WebAPIのファイルアップロード時に特殊文字が利用されるファイル名を制限しました。

  • 対象のエンドポイント
    • POST:/documents/{documentID}/files
  • 対象
    • “を含む場合
    • ファイル名末尾が\"の場合
    • ファイル名末尾が\の場合

2026-03-26

  • GET /cabinet_documents のリクエストパラメータ「page」において、上限値（100）を超えた値を設定した際のエラーコードを「500（Internal Server Error）」から「400（Bad Request）」に変更しました
  • GET /cabinet_documents のレスポンスパラメータ「total」の条件を、閲覧権限がある書類のみの件数を表示するように変更しました

2026-02-12

Web APIで使用するクライアントIDを削除する操作が、監査ログに記録されるようになりました。

2026-01-13

Web API のリクエストにおいて、書類タイトルや契約相手の名称などの文字列に含まれるスペースの処理を、以下の通り変更いたしました。

  • 文字列中の全角スペースを保持
    • これまでは、全角スペースを自動的に半角スペースへ変換していましたが、今後は、全角スペースが含まれている場合でもリクエストの文字列をそのまま保持します。
  • 先頭・末尾のスペースを自動削除
    • 半角・全角問わず、先頭・末尾にスペースが入っている場合は、自動的に削除されるようになりました。

2025-12-11

Web APIでアップロード可能なファイルサイズの上限が以下の通り変更になりました。

  • 1ファイルあたりのデータサイズ：〜50MB（52,428,800Bytes）
  • 全てのファイルの合計データサイズ：〜200MB（209,715,200Bytes）

2025-11-27

Web APIで使用するクライアントIDを発行する操作が、監査ログに記録されるようになりました。

2025-11-20

エンタープライズプランをご利用のお客様が、Web API からキャビネット内の書類一覧を取得可能になりました。

新規追加となるエンドポイント

  • キャビネット内の書類一覧を取得
    • GET /cabinet_documents

2025-10-14

以下エンドポイントにおいて、1分間あたりのリクエスト回数に上限（閾値）を設定します。

 

    • 対象のエンドポイント
      • 合意締結証明書の取得（ /documents/{documentID}/certificate ）
    • 閾値
      • 同一のアクセストークンを用いたリクエストは1分間に800回まで

2025-10-08

「フリーテキスト」ウィジェットのフォントサイズを変更できるよう、以下の変更を行います。

  1. フォントサイズの変更を受け付けられるようにします。
    • 対象のエンドポイント
    • POST:/documents/{documentID}/files/{fileID}/widgets

      PUT:/documents/{documentID}/files/{fileID}/widgets/{widgetID}

  2.  documentModel > files > widgets にパラメータ「font_size」を追加します。

    • 対象のエンドポイント
    • POST:/documents

      GET:/documents

      GET:/documents/{documentID}

      PUT:/documents/{documentID}

      POST:/documents/{documentID}

      POST:/documents/{documentID}/files

      GET:/documents/{documentID}/files/{fileID}

      DELETE:/documents/{documentID}/files/{fileID}

      POST:/documents/{documentID}/participants

      PUT:/documents/{documentID}/participants/{participantID}

      DELETE:/documents/{documentID}/participants/{participantID}

      POST:/documents/{documentID}/files/{fileID}/widgets

      PUT:/documents/{documentID}/files/{fileID}/widgets/{widgetID}

      DELETE:/documents/{documentID}/files/{fileID}/widgets/{widgetID}

      POST:/documents/{documentID}/reportees

      PUT:/documents/{documentID}/reportees/{reporteeID}

      DELETE:/documents/{documentID}/reportees/{reporteeID}

      POST:/documents/{documentID}/attachments

      PUT:/documents/{documentID}/attachments/{attachmentID}

      DELETE:/documents/{documentID}/attachments/{attachmentID}

      GET:/team_documents

  • 2025-09-26

    バージョン 0.28.0

    書類のアラート機能が Web API でも利用可能になりました。これに伴い、下記のアップデートを行いました。

    新規追加となるエンドポイント

      • 書類のアラート情報を取得

      GET /documents/{documentID}/alert

      • 書類のアラート情報を作成・更新

      PUT /documents/{documentID}/alert

       

      その他の変更点

      • documentAlertModel を追加しました。

      2025-08-19

      エンタープライズプランをご利用のお客様において、書類関係者でないユーザーが以下のリクエストを実行した場合、いずれかのキャビネットを介してアクセス可能な書類については403エラーを返さないようにしました。

      • 対象

        GET /documents/{documentID}
        GET /documents/{documentID}/attribute
        GET /documents/{documentID}/files/{fileID}
        GET /documents/{documentID}/attachments/{attachmentID}/attached_files/{attachedFileID}
        GET /documents/{documentID}/certificate
        PUT /documents/{documentID}/attribute

       

    • 2025-08-18

      書類に関連するレスポンスに却下理由を取得できるよう、documentModelにパラメータ「decline_comment」を追加いたしました。

      • 対象のレスポンス

        GET:/documents/{document_id}
        GET:/documents
        GET:/team_documents

      2025-07-24

      APIドキュメント管理ツールの見直しにともない、Web API 仕様書の公開バージョンを「2022年3月 の0.19.0 から 2024年5月の 0.27.10 」までに変更します。

      提供するWeb API の内容や仕様に変更はございませんが、0.19.0以前のバージョンは、本ページにてご確認ください。

      2025-05-27

    • 送信者が取り消した書類について、受信側チームの書類関係者および、書類管理者はWeb API経由で書類を閲覧・確認することができなくなりました。

    • 2024-08-29

    • Web API経由で送信取り消しした際にもWebhook通知が行われるようになりました

    • 2024-05-17

    • バージョン 0.27.1

    •  

    • エンタープライズプランをご利用のお客様において、書類関係者でないユーザーが以下のリクエストを実行した場合、403エラーになる説明を加筆しました。

      • 対象

    • GET /documents/{documentID}/attribute

      PUT /documents/{documentID}/attribute

      GET /documents/{documentID}/certificate

      GET /documents/{documentID}/files/{fileID}

      GET /documents/{documentID}/attachments/{attachmentID}/attached_files/{attachedFileID}

    •  

      2024-03-13

    • バージョン 0.27.0

    • POST /imported_documentsに関して、以下のアップデートを行いました。

      • name と uploadfile のファイル名で拡張子が不正だった場合のレスポンスメッセージを変更

        • レスポンスコードや挙動に変更なし

      • SwaggerHubに400エラーになる条件を加筆

        • uploadfile のファイル名が空の場合

        • name が空で、かつ以下のいずれかの条件に該当する場合

          • uploadfile のファイル名が68文字を超える場合

          • uploadfile のファイル名の末尾が `.pdf` でない場合

          • uploadfile のファイル名が拡張子のみの場合

          • uploadfile のファイル名の拡張子の前が空白のみの場合

    •  

    • 2024-03-06

    • バージョン 0.26.0

    • ファイルのアップロード上限を100件に変更しました。また、SwaggerHubに仕様の説明を加筆しました。

      • POST /documents/{documentID}/filesの説明を修正

        • 400エラーになる条件として、「アップロードしたファイルの合計件数が 100件 を超えた場合」を追加

    •  

    • 2024-02-15

    • バージョン 0.25.0

    • 書類インポート機能が Web API でも利用可能になりました。これに伴い、下記のアップデートを行いました。

    • 新規追加となるエンドポイント

      • 書類のPDFファイルをアップロードする

    • POST /imported_documents

      • キャビネット一覧の取得（エンタープライズプランのみ利用可能）

    • GET /cabinets

    •  

    • 2023-12-13

    • バージョン 0.24.2

    •  

    • 総合行政ネットワークLGWANにて、Web APIが利用できるようになりました。これに伴い、以下説明を加筆しました。

      • GET /documents/{documentID}/files/{fileID} の説明を修正

        • 400 エラーになる条件として、「LGWAN環境ではダウンロードできないファイルを指定した場合」を追加

      • GET /documents/{documentID}/attachments/{attachmentID}/attached_files/{attachedFileID} の説明を修正

        • 400 エラーになる条件として、 「LGWAN環境ではダウンロードできないファイルを指定した場合」を追加

    •  

    • 2023-07-25

    • バージョン 0.24.1

    • マイナンバーカード署名機能リリースに伴い、SwaggerHub に仕様の説明を加筆しました。

      • POST /documents/{documentID} の説明を修正

        • 400エラーになる条件として、「送信者にマイナンバーカード署名が指定されている場合」を追加

      • POST /documents/{documentID}/participants のパラメータ callback の説明を修正

        • 400エラーになる条件として、「宛先にマイナンバーカード署名が指定されている場合」を追加

      • PUT /documents/{documentID}/participants のパラメータ callback の説明を修正

        • 400エラーになる条件として、「宛先にマイナンバーカード署名が指定されている場合」を追加

      • participantsModel の callback フィールドの説明を修正

    •  

    • 2023-07-05

    • バージョン 0.24.0

    •  

    • 組込み署名（SMS認証）機能リリースに伴い、下記のアップデートを行いました。

      • 新規追加となるエンドポイント

        • 組込み署名の受信者の同意URL取得

          • 組込み署名が設定された受信者について、同意 URL と有効期限の情報が返却される

    • POST /documents/{documentID}/participants/{participantID}/signing_url

    •  

      • その他の変更点

        • participantsModel に組込み署名の設定に必要なパラメータ tel と callback を追加

        • POST /documents/{documentID} の説明を修正

          • 400 エラーになる条件として、 「組込み署名（SMS認証）が設定された受信者にリマインドを行おうとした場合」を追加

        • POST /documents/{documentID}/participants のパラメータ language_code の説明を修正

          • callback が true のとき ja（日本語）のみ指定可能なことを追加

        • POST /documents/{documentID}/participants required から email を削除

          • 組込み署名（SMS認証）では email の指定が不要になるため削除

        • PUT /documents/{documentID}/participants/{participantID} のパラメータ language_code の説明を修正

          • callback が true のとき ja（日本語）のみ指定可能なことを追加

    •  

    • 2023-05-25

    • バージョン 0.23.0

      • 操作不可の状態(ステータス)にある書類や添付ファイルにアクセスした場合に error レスポンスのステータスコード403を返却するよう変更いたしました。

         

        これまで：ステータスコード406

        アップデート後：ステータスコード403

    •  

    • 2023-03-03

    • バージョン 0.22.0

      • API オプションの契約が無いユーザーからのアクセスの場合の error レスポンスのステータスコードを変更いたしました。

         

        これまで：ステータスコード402

        アップデート後：ステータスコード403

    •  

    • 2023-02-27

    • バージョン 0.21.0

      • 以下のエンドポイントにおいて、requiredパラメータに不正な値を指定した場合のエラーレスポンスの不具合を修正しました。

    • POST/documents/{documentID}/files/{fileID}/widgets

      PUT/documents/{documentID}/files/{fileID}/widgets/{widgetID}

    •  

    • 2023-02-16

    • バージョン 0.21.0

    • 高度な認証による署名機能が Web API でも利用可能になりました。

    •  

    • API変更内容

      • 以下のエンドポイントで高度な認証による署名機能の有効／無効を切り替えるパラメータ「advanced_authn_request」を設定できます。

    • POST /documents/[docID]/participants

      PUT /documents/[docID]/participants/[particID]

      • パラメータの値にしたがい、高度な認証による署名機能 は以下のように設定されます。

        • 1 または true ：有効

        • 0 または false：無効

        • 未入力時：無効

      • 受信者情報が含まれるレスポンスに 高度な認証による署名機能 が設定されているかを判別できるパラメータを追加しました。

        • participantModelにパラメータ「advanced_authn_request」を追加

    • 利用時の注意点

      • 受信者の言語が日本語の場合のみ利用ができます

      • 日本語以外を指定した場合は400エラーが返却されます

    •  

    • 2022-12-01

    • バージョン 0.20.0

    • 受信者ファイルアップロード機能リリースに伴い、下記のアップデートを行いました。

    •  

    • 新規追加となるエンドポイント

      • 添付資料のアップロードリクエストの作成

    • POST /documents/{documentID}/attachments

      • 添付資料のアップロードリクエストの更新

    • PUT /documents/{documentID}/attachments/{attachmentID}

      • 添付資料のアップロードリクエストの削除

    • DELETE /documents/{documentID}/attachments/{attachmentID}

      • 添付ファイルの取得

    • GET /documents/{documentID}/attachments/{attachmentID}/attached_files/{attachedFileID}

    •  

    • その他の変更点

      • documentModel に attachment を追加します

      • GET /documents, GET /team_documents に任意のパラメータ with_attachment を追加します

      • PUT /documents/[docID]/decline で書類に添付ファイルが登録されている場合に添付ファイルのステータスを変更し、添付ファイルを削除します

      • 「attachment」は「添付資料」（アップロードされたPDFを格納する箱）と呼称します

      • 「attachedFile」 は 「添付ファイル」（実際にアップロードされるPDF）と呼称します

    •  

    • 2022-08-22

    • バージョン 0.19.1

    • エンタープライズプランをご利用のお客様が下記のエンドポイントや操作を利用しようとすると、レスポンスコード403を返却するようになりました。

    • /team_documents

    • 例）GET /team_documents：メンバー全員がやり取りした書類一覧の取得

    • /me

    • 例）GET /me ：APIを実行しているユーザーのユーザー情報およびチーム情報の取得

    •  

    • 2022-05-10

    • バージョン 0.19.0

      • 書類送信時の1ファイルあたりの上限サイズを下記のように変更しました。

        これまで：1ファイルあたりの上限10MB

        アップデート後：1ファイルあたりの上限20MB

    • 2022-01-27

    • バージョン 0.18.0

      • クラウドサインで送信や合意を行う関係者を参加者（participant）と呼びます。今回のアップデートでは participant の状態に新たな「署名中」という状態（ステータス）を追加しました。

    •  

    • 2021-11-15 Webhookの仕様変更

      • Webhookの発信元IPアドレスを追加しました。
        追加前：52.68.17.229/32　または　52.198.144.82/32
        追加後：52.68.17.229/32　または　52.198.144.82/32　または　3.112.114.42

    •  

    • 2021-10-22

    • バージョン 0.17.0

      • 「書類を最後に処理した日時」を用いて書類一覧が取得できるようになりました

      • 詳細はこちら

    • 2021-06-21

    • バージョン 0.16.0

      • 末尾が %%EOF で終わらない構造のファイルをアップロードするとレスポンスコード400を返すようになりました

    • 2021-02-18

    • バージョン 0.15.0

      • 親展書類を送信できるようなりました（ビジネスプランのみ）

      • 取得した書類が親展かどうかわかるようになりました

    • 2021-02-08

    • バージョン 0.14.4

      • SwaggerHub に仕様の説明を加筆しました。

    • 2021-01-20

    • バージョン 0.14.3

      • SwaggerHub に仕様の説明を加筆しました。

    • 2020-12-23

    • バージョン 0.14.2

      • SwaggerHub に仕様の説明を加筆しました。

    • 2020-07-20

    • バージョン 0.14.0

      • 下書き状態の書類を削除できるようになりました

      • 入力項目の作成、更新時のリクエストパラメータx、ｙが不正なとき、レスポンスコード400を返すようになりました

    • 2020-06-04

    • バージョン 0.13.0

      • 共有先の設定・取得ができるようになりました

      • GET /token を非推奨とするドキュメント修正

    • 2020-05-19

    • バージョン 0.12.1

      • 契約相手の名称のmaxLengthを修正

    • 2020-04-27

    • バージョン 0.12.0

      • ユーザープロファイル情報を取得できるようになりました

      • POSTによるトークン取得ができるようになりました

    • 2020-04-16

    • バージョン 0.11.1

      • ファイルの取得のresponseの記述を修正

    • 2020-01-24

    • バージョン 0.11.0

      • 取得する書類データに「書類に同意した/却下した日時」が追加されました

      • 他メンバーの作った共有テンプレートを取得できるようになりました

      • API経由でチェックボックスを配置できるようになりました

    • 2019-07-25

    • バージョン 0.10.5

      • documentModelのtiitleのmaxLengthを追記しました

    • 2019-04-10

    • バージョン 0.10.4

      • 仕様の誤りを修正

    • 2019-03-28

    • バージョン 0.10.3

      • APIの仕様書のフォーマットをOpenAPI 3.0 にしました

    • 2019-03-14

    • バージョン 0.10.2

      • /team_documentsの説明に、取得できる書類の状態としてインポート書類を追加

      • 書類の状態にインポート書類を追加

    • 2019-03-01

    • 仕様変更

    •  

    • バージョン 0.10.1

      • format: uuid と定義していた部分を、 32文字以上36文字以下の文字列 に変更します

      • 定義の変更を行う項目
        ​access_token, user_id, document_id, file_id, widget_id 及び participant_id

    • ID形式の変更

      • 一部のIDについて、新規発行分より形式を変更します

      • ID形式の変更を行う項目
        ​document_id, file_id, widget_id 及び participant_id

      • access_token 及び user_id に関しては仕様書上のフォーマット定義のみの変更となります

      • 段階的な変更を予定しています

      • 該当部分については、UUID v4形式から独自形式への変更を行います。

      • 文字列長が36文字から、32文字になります。

      • ハイフンによる区切りがなくなります。

      • ASCII文字列からなり、UUID v4 には含まれていない文字も使用されます。

    • 例

      旧ID：b448730f-23db-40bd-9397-f64dbe5d6f59

      新ID：01dhf3fnt39w5qxqrq69neeawhvjyfy1

    •  

    • 2019-02-20

    • バージョン 0.10.0

      • 機能追加 合意締結証明書 取得

    • 2019-02-08

    • バージョン 0.9.1

      • 仕様の誤りを修正

    • 2019-02-06

    • バージョン 0.9.0

      • 機能追加 書類情報取得、作成・更新

    • 2018-11-08

    • バージョン 0.8.0

      • 機能追加入力項目のラベルの設定及び取得

    • 2018-08-22

    • バージョン 0.7.3

      • 仕様の誤りを修正

    • 2018-06-14

    • バージョン 0.7.2

      • 仕様の誤りを修正

    • 2018-06-01

    • バージョン 0.7.1

      • 仕様の誤りを修正

    • 2018-05-15

    • バージョン 0.7.0

      • 機能追加受信者に設定したアクセスコードの取得受信者がアクセスするURLの有効期限の取得

    • 2018-05-14

    • バージョン 0.6.1

      • 時刻フォーマットの誤りを修正

    • 2018-05-01

    • バージョン 0.6.0

      • アップロードできるファイル容量の上限を拡張

    • 2018-02-17

    • バージョン 0.5.1

      • 却下機能の仕様の修正

      • pageパラメータの値が不適切な場合のエラーを追加

    • 2018-02-02

    • バージョン 0.5.0

      • エラー条件の追加

      • パラメータのデフォルト値の設定を’追加

      • 未設定が許容されるパラメータの記述を追加

    • 2017-12-19

    • バージョン 0.4.0

      • 機能追加転送設定

    • 2017-12-12

    • バージョン 0.3.20171212

      • エラーコード修正

    • 2017-11-16

    • バージョン 0.3.20171116

      • エラー条件の追加

    • 2017-11-10

    • バージョン 0.3.20171110

      • 機能追加却下機能受信者の言語設定

    • 2017-06-22

    • バージョン 0.3.20170622

      • 表記の誤りを修正

    • 2017-05-31

    • バージョン 0.3.20170531

      • 仕様の誤りを修正

    • 2017-04-04

    • バージョン 0.3.20170404

      • SwaggerHub で仕様を公開

    • 2016-10-21

    • バージョン 0.1.0