developers · Sep 21, 2025
n8nを例に、Quire APIでQuireと外部ツールを連携する方法
最終更新日：2026年7月20日
このガイドでは、n8nを自動化プラットフォームの例として、Quire APIを使ったカスタム連携を構築します。手順は6つです。Quireアプリを登録し、n8nを起動し、OAuth2を設定し（AuthenticationフィールドはBodyにする必要があります）、/task/list/id/{projectId}でタスクをGETし、/task/id/{projectId}でタスクをPOSTし、最後にsourceRefで元データのメタ情報を付与します。同じパターンはZapierなど他のノーコード/ローコードプラットフォームでも使えます。
Quireは、プログラムからQuireのタスクを読み書きできるオープンAPIを提供しています。アプリディレクトリに掲載されている多くのアプリは、Quire APIと直接やり取りすることで作られています。
既存のアプリがニーズに合わない場合は、カスタム連携を構築しましょう。この記事では、自動化プラットフォームの例としてn8nを使いながらQuire APIの使い方を解説します。同じ考え方はZapierなど他のローコードプラットフォームにも当てはまります。
こうしたアプローチは今や当たり前になりつつあります。Gartnerの試算によると、2025年までに組織が開発する新しいアプリケーションの70%がローコードまたはノーコード技術を使うようになり、2020年時点の25%未満から大きく増加するとされています。n8nは、そのカテゴリーで最も広く使われているオープンソースの選択肢の一つです。
このガイドで使用するQuire APIエンドポイント
| 操作 | メソッド | エンドポイント | 主なフィールド |
|---|---|---|---|
| プロジェクトのルートタスクを読み取る | GET | /task/list/id/{projectId} |
— |
| タスクを作成する | POST | /task/id/{projectId} |
name, description |
| 元データのメタ情報を付与する | POST/PUTフィールド | sourceRef.text（Markdown）、任意のカスタムキー |
タスク詳細に表示 |
| アプリを実行者としてアクティビティに表示する | リクエストフィールド | asUser: true |
アクティビティーログにアプリ名が表示される |
実装手順は？
- Quireでアプリを作成し、APIの認証情報を取得する
- n8nインスタンスを準備して起動する
- n8nでOAuth2認証を行う
- 最初のAPIリクエストを送る（タスクの読み取り）
- APIでタスクを作成・変更する（書き込み）
- sourceRefでソース参照やカスタムメタ情報を保存する
1. Quireでアプリを作成する
Quire APIにアクセスするには、Quireにアプリを登録し、クライアントIDとクライアントシークレットを取得し、OAuth2用のリダイレクトURIを設定する必要があります。
API付きのQuireアプリを作成する手順については、こちらのブログ記事をご覧ください。
2. n8nを準備する
テスト用にn8nを無料でセルフホストできます。詳しくは公式ドキュメントをご覧ください。
起動したら、新しいワークフローを作成し、APIリクエストの実行やレスポンス処理を行うノードを追加していきます。
3. OAuth2で認証する
Quireは認可にOAuth2を使用しています。n8nでクレデンシャルを作成すれば、トークン交換を代行してくれます。
- ワークフロー画面で新しいクレデンシャルを追加し、OAuth2オプションを選択します。
- Quireアプリの設定から、クライアントID、クライアントシークレット、認可URL、トークンURL、リダイレクトURIを入力します。リダイレクトURIはn8n側からコピーし、Quireアプリの設定に貼り付けて、OAuth2フローが正しく機能するようにする必要があります。n8nでは、「Authentication」フィールドを必ず
Bodyに設定し、Quireが要求する形式でクレデンシャルが送信されるようにしてください。
- Connect to my accountをクリックすると、n8nがQuireの認可ページにリダイレクトします。認可するプロジェクトを選び、フローを完了させてください。
4. 最初のAPIリクエストを送る（タスクの読み取り）
Quire APIドキュメント：https://quire.io/dev/api/
n8nのHTTP Requestノードを使ってAPIを呼び出します。例として、あるプロジェクトのルートタスクをすべて取得してみましょう。
- ベースURL：
https://quire.io/api - エンドポイント：
/task/list/id/{projectId}（{projectId}は、プロジェクトURL（通常はhttps://quire.io/w/<projectId>）に含まれるプロジェクトIDに置き換えてください）
HTTP Requestノードでは、以下のように設定します。
- メソッド：GET
- URL：
https://quire.io/api/task/list/id/<your_project_id> - Authentication：Generic Credential Type
- Generic Auth Type：OAuth2 API
- OAuth2 API：
<先ほど作成したクレデンシャル>
ノードを実行すると、右パネルにレスポンスデータが表示されます。そのデータを後続のノードに渡して処理できます。
5. タスクを作成・変更する（書き込み）
APIを使ってタスクを作成できます（ドキュメントの新しいタスクの追加を参照してください）。
- エンドポイント：
/task/id/{projectId}
n8nのHTTP Requestノードでは、以下のように設定します。
- メソッド：POST
- URL：
https://quire.io/api/task/id/<your_project_id> - Send Bodyを有効にし、必須フィールド（例：
name）と、任意フィールド（descriptionなど）を入力します。
Send Bodyを有効にしたら、Body Content TypeをJSONに、Specify BodyをUsing JSONに設定してください。これにより、以下のサンプルコードのようにリクエストボディをJSON形式で入力できるようになります。
{
"name": "Example task",
"description": "Created via n8n"
}
ノードを実行すると、レスポンスに作成されたタスクの詳細が含まれ、Quireのプロジェクト上にもそのタスクが表示されます。
6. sourceRefでソース参照やカスタムデータを扱う
sourceRefを使ったリクエストボディの例：
{
"name": "Task from n8n",
"description": "Automated task",
"sourceRef": {
"text": "[Open in MyApp](https://example.com/item/123)",
"meta": { "workflowId": "n8n-abc-123" }
}
}
sourceRefは、タスクに関連するカスタムデータを保存するために用意されたフィールドです。あらかじめ定義されているフィールドはtextだけで、Markdownに対応しており、Quireのタスク詳細に表示されます。リンクや短い説明をユーザーがクリックできるようにするのに最適です。
sourceRefの下に追加する他のフィールドは、完全に自分のアプリケーション次第です。たとえば、識別子やフラグを保存するためにmetaオブジェクトや他のキーを含めることもできますが、これらは任意です。
APIでタスクを読み取る際は、返されたJSONの中のsourceRefオブジェクトを確認してください。textフィールドや、自分で保存したカスタムデータにアクセスできるため、自動化処理が元データを追跡したり、後続処理用の追加情報を保持したりしやすくなります。
タスクの作成・更新時にもう一つ役立つフィールドがasUserです。
asUserをtrueに設定すると、アクティビティーログにはそのタスクを作成・更新したユーザーとしてQuireアプリの名前が表示されます。これにより、ユーザーはどのタスクがAPI連携によって作成されたのかを識別しやすくなります。
Quire APIのエラーにはどう対処すればいいですか？
Quire APIを呼び出す際に発生する問題のほとんどは、4つのHTTPステータスコードで説明がつきます。それぞれに対応する具体的な解決策があります。
- 401 Unauthorized：OAuth2トークンが有効かつ期限切れでないか確認してください。クレデンシャルの設定が正しいかも確認しましょう。
- 400 Bad Request：リクエストボディとパラメータを見直してください。JSON形式が正しいか、必須フィールドが含まれているか確認します。
- 403 Forbidden：アプリとユーザーが、そのプロジェクトやリソースにアクセスする権限を持っているか確認してください。
- 404 Not Found：使用しているAPIエンドポイントと、プロジェクト・タスクのIDを再確認してください。
エラーメッセージや必須パラメータの詳細については、必ずQuire APIのドキュメントを参照してください。エラーが発生した場合は、レスポンスメッセージをよく読んでください。多くの場合、問題の原因についてのヒントが含まれています。
Quire APIで双方向同期を実装するには？
参照記事で紹介されているように、n8nとQuire APIを使って自分自身の双方向同期の仕組みを構築することもできます。
実践的な例として、私たちのオープンソースリポジトリをご覧ください。n8n Quire APIには、手順を追ったガイドと実際に動くテンプレートが含まれており、自分のアプリとQuireの間で双方向同期を実装しやすくなっています。
Quire APIで双方向同期を構築する手順については、こちらのブログ記事をご覧ください。
次に何をすればいいですか？
これで、タスクの読み取り、タスクの作成、sourceRefによる元データのメタ情報の付与、asUserによるアクティビティーログ上での自分の連携の識別まで、一通り行えるようになりました。同じパターンは他のQuire APIエンドポイントにも応用できます。詳しくは公式APIドキュメントを参考にしてください。
問題が発生した場合は、上記のエラー処理のセクションで、よくある4つのHTTPレスポンスへの対処法を紹介しています。それ以外の問題については、feedback@quire.ioまでメールでお問い合わせください。
関連記事：Quire MCPを5分でセットアップ：Claude、ChatGPT、その他のAIクライアントと連携する — カスタムAPI呼び出しを書く代わりにAIクライアントを直接Quireと連携させたい場合は、MCPの方が近道です。
関連記事：Quire Webhookのセットアップ手順ガイド — Webhookを使えば、ワークフローがAPIをポーリングする代わりに、Quire上で何かが変更された瞬間に自動化処理へ更新情報がプッシュされます。
よくある質問
Quire APIとは何ですか？何ができますか？
プログラムからQuireのタスクを読み書きできるオープンAPIです。アプリディレクトリにある既存のアプリが自分のニーズに合わない場合に、カスタム連携を構築するために使います。
Quire APIの認証はどうやって行いますか？
QuireはOAuth2を使用しています。Quireアプリを登録してクライアントIDとシークレットを取得し、n8nのAuthenticationフィールドをBodyに設定して、Quireが期待する形式でクレデンシャルが送信されるようにしてください。
n8nを使ってQuireと連携できますか？
はい。n8nを無料でセルフホストするか、n8n.cloudを使い、HTTP RequestノードとOAuth2クレデンシャルでタスクを読み書きできます。同じパターンはZapierなど類似のプラットフォームにも当てはまります。
Quire APIのsourceRefとは何ですか？
sourceRefはタスクにカスタムデータを保存するためのフィールドです。あらかじめ定義されているtextフィールドはMarkdownに対応しており、タスク詳細に表示されます。また、metaのような他のキーを追加して、元データを追跡したり自動化処理のメタ情報を保持したりできます。
Quire APIがエラーを返したときは何を確認すればいいですか？
401はトークンの問題、400はリクエストボディの不備、403は権限の問題、404はエンドポイントやIDの誤りを示します。レスポンスメッセージを読んでください。たいていそこに解決の手がかりがあります。
