対象
Growthプラン契約者
（またはAPIオプションを個別にご契約のお客様）
概要
Mazricaは、外部システムと連携するためのAPIを公開しています。
2026年8月19日より、現行のAPI（以下v1）に加えて新たに「Mazrica Open API v2」の提供を開始しました。
v1の仕様変更ではなく、v1とは別系統の新しいAPIです。v1のAPIキーや連携設定に変更はなく、引き続きご利用いただけます。
v2はAIエージェントやMCP（Model Context Protocol）からの利用を想定した新しいAPIで、
v1よりセキュリティ・性能が強化されています。
新規に連携を構築される場合や、より高いセキュリティ・AI連携をご検討の場合はv2のご利用をおすすめします。
v1・v2いずれもGrowthプラン以上（またはAPIオプションを個別にご契約のお客様）でご利用いただけます。
v2でご利用いただけるのは取引先・案件・コンタクト・アクション・案件コンタクトの基本操作のみです。対応エンドポイントは今後順次拡大予定です。
v2の詳しい仕様やv1との違い、移行方法はこちらをご確認ください。
APIキーの発行方法
v1をご利用の場合
メニュー＞管理者設定＞API利用（従来どおり）
v2をご利用の場合
v2では、用途に応じて2種類のAPIキー（アクセストークン）を発行できます。
種類 | 発行場所 | 推奨用途 |
個人APIキー（PAT） | 設定 ＞ 個人設定 ＞「API利用」タブ | 個人の権限内でAI（MCP）等を介してデータ操作を行う場合 |
チームAPIキー（TAT） | 設定 ＞ API利用 ＞「（新）API利用」タブ | 特定の利用者に依存しないシステム間連携（推奨） |
発行時にはキーの有効期限の設定が必須です（無期限は選択できません）。
PAT・TATともに、それぞれ最大2個まで同時に発行できます（切り替え用）。
チームAPIキー（TAT）は発行時に1度だけ表示され、再表示はできません。発行時に必ずコピーし、安全な場所に保管してください。
設定＞個人設定＞「API利用」タブは、デフォルトではプロファイル「管理者」のみご利用いただけます。他のプロファイルでもご利用になる場合は、設定＞権限＞プロファイルの「個人設定＞API利用」をONにしてください。
v1からv2への具体的な移行手順（認証ヘッダーや接続先URLの変更など）は、こちらをご参考ください。
APIのリクエスト上限数
項目 | v1 | v2 |
秒間リクエスト制限 | 3リクエスト/秒 | 5リクエスト/秒（PAT・TAT共通） |
日次リクエスト制限 | 1ドメイン 50,000リクエスト/日 | PATは1ユーザー50,000リクエスト/日、 TATは1ドメイン200,000リクエスト/日 （同一ドメインに複数TATがある場合も合算） |
リクエスト上限数を増やす場合は有料となります。
具体的な金額などはsuccess@mazrica.com、またはチャットサポートまでお問い合わせくださいませ。
v2利用時の注意事項
v2ではページング方式やカスタム項目のレスポンス形式、通知の送信有無などがv1と異なります。
既存のv1連携をお持ちの場合は、移行前に必ずこちらの「v1からの変更点」をご確認ください。
特に以下の点にご注意ください。
ロック中の案件を更新する場合、個人APIキー（PAT）では基本項目・商品内訳の更新がエラーになることがあります（プロファイルで更新権限を持つユーザーは除く）。
チームAPIキー（TAT）は従来どおり更新可能です。
その他
よくあるご質問
外部ツールとの連携はできますか？
対象外部ツールがAPIを公開している場合、開発頂くことで連携が可能です。
(弊社では連携の開発は承っておりません。ご容赦下さい。)
v1とv2、どちらを使えばよいですか？
既存のv1連携はそのままご利用いただけます。新規に連携を構築される場合や、
より高いセキュリティ・AIエージェント/MCPとの連携をご検討の場合はv2をおすすめします。
PAT（個人APIキー）とTAT（チームAPIキー）、どちらを使えばよいですか？
特定のユーザーに依存しない、システム間連携としてご利用の場合はTATをおすすめします（従来のAPIキーに近い使用感）。
個人の権限内でAIエージェント等を介してご自身の担当データを操作したい場合はPATをご利用ください。
HTTP/1.1 403 Forbiddenを含むエラーが返されました
以下の点をご確認ください。
正しいAPIキーを取得しているか
Windows端末利用ユーザーは、「'」を「"」に変換することでエラーが解消する場合がございます。
現在のAPIリクエスト数が何件か確認できますか？
Mazrica上での計測はできません。
APIリクエスト数はお手元にて確認いただく必要がございます。
なお、リクエスト数超過時は追加料金がかかるのではなく、エラーとして返されます。
APIのリクエスト上限数は50,000リクエスト/日となり、リクエスト上限数を増やす場合は有料となります。詳しくはこちらをご確認ください。