よくみられるFAQ

FAQ TOPへ移動

✖

freeeサイン Web API・Webhook 利用ガイド

API利用の申込
APIクライアント設定ページにアクセス
client_id と client_secret を発行
client_id, client_secret を使用できることを確認
APIリクエストについて
リクエスト上限について
SwaggerUIの使い方
Webhook について

freeeサイン Web API 利用手順

API利用の申込

（１）画面右下のチャットツールをクリックします。

（２）「メッセージを送信」をクリックします。

（３）API利用したい、または、検討している旨の内容を入力していただき、送信ボタンをクリックします。

（４）送信完了した場合は以下のような表示になります。
お手続きが完了し次第、API利用の権限付与がなされます。

（５）権限が付与されれば２以降の操作が行えるようになります。

APIドキュメント（https://ninja-sign.com/v1/docs）に関しては、権限関係なく閲覧できるので、ご参照ください。

APIクライアント設定ページにアクセス

「設定」をクリックし、「APIクライアント」をクリックしてページにアクセスします。

client_id と client_secret を発行

（１）client_id と client_secret を発行する、APIクライアント名をクリックします。

（２）client_id と client_secret が確認できます。
client_idとclient_secretを利用してアクセストークンを発行することができます。アクセストークンの有効期限は24時間（86400秒）です。有効期限があるのでアクセストークン自体は自社システムに固定設定しないでください。

client_id, client_secret を使用できることを確認

（１） curlでのリクエスト例

（２）処理が正常に完了すると、左記の様なアクセストークンを含むJSON が表示されます。

（３）アクセストークン発行のタイミングについての注意
１リクエストごとにアクセストークンを再発行するような処理は、リクエスト上限などの問題から、行わないようにご注意ください。

APIリクエストについて

APIリクエストできる項目について、簡単に記載します。

7ー2〜10に関しては、2020年9月現在の説明です。最新のリクエストできる項目、および、リクエストとレスポンスの一覧の詳細に関してはAPIドキュメント（ https://ninja-sign.com/v1/docs ）を参照ください。

freeeサイン Web API 利用例

クイック作成をする

ユーザーAからテンプレートAの内容でメールアドレスXに送りたい場合

（０）事前にAPI経由ではなくユーザーA・テンプレートAを準備する。
（１）client_id, client_secret を用いてアクセストークンを発行
（２）「7−2. 文書作成」
既にあるユーザーA・テンプレートAを指定する。
（３）「7−4. 文書送信」
(2)で作成した文書のID・ユーザーA・メールアドレスXを指定する

文書一覧を取得し、検索項目を付与する

文書Aに対して検索項目を付与したい場合

（１）client_id, client_secret を用いてアクセストークンを発行
（２）「7−3. 契約書一覧の取得」
文書AのIDを取得
（３）「7−5. 検索項目付与」
(2)で取得した文書AのIDを指定し、検索項目を付与する。

7-2.文書作成

文書をクイック作成します。
テンプレート・入力項目・作成者となるユーザー・フォルダーなどの情報が指定できます。

7-3.文書一覧の取得

文書一覧を取得します。

7-4.文書送信

同チームのユーザーが作成した文書のIDを指定することで、検索項目を付与することができます。

7-5.検索項目付与

文書をクイック作成します。
テンプレート・入力項目・作成者となるユーザー・フォルダーなどの情報が指定できます。

7-6.ユーザー一覧の取得

ユーザー一覧を取得します。
ここで取得できるユーザーには、チーム内のユーザー、文書の作成者、文書の受領者が含まれます。
そのため、複数のチームのユーザーが含まれる場合があります。
自チームのユーザーだけ取得する場合は、team_idを指定する必要があります。

ユーザーを招待します。

特定のユーザーを退会させます。

フォルダー一覧を取得します。

テンプレート一覧を取得します。

マイ印鑑一覧を取得します。

チーム一覧を取得します。
ここで取得できるチームには、自チーム、文書の作成者・受領者の属するチームが含まれます。
そのため、複数のチームが含まれる場合があります。

リクエスト上限について

同一IPからのリクエストは1秒間に5回までです。
もし制限を超えた場合、「429 Too Many Requests」のレスポンスが返ります。

SwaggerUIの使い方

SwaggerUIはAPIの仕様を確認できるだけでなく、APIの動作確認をコードなしで簡単に行えます。
SwaggerUIで、アクセストークンを発行し、APIリクエストを行うまでの手順について説明します。（実際のアカウントのデータで取得・作成などを行えます。）
こちらの項目は実際に業務に組み込む手順を簡単に確認するもので、APIリクエストを行うために必須の作業ではありません。
また、SwaggerUIはあくまで動作確認用になるので、実運用にSwaggerUIの操作を組み込むのはおすすめいたしません。