リクエスト制限

すべての API ユーザーに一貫した開発エクスペリエンスを保証するために、Notion API はレート制限されており、基本的なサイズ制限がリクエストのパラメータに適用されます。

レート制限

レート制限されたリクエストは、"rate_limited"エラー コード (HTTP レスポンス ステータス 429) を返します。インテグレーションごとの受信リクエストのレート制限は、1 秒あたり平均 3 リクエストです。平均レートを超える一部のバーストは許可されます。

インテグレーションは、HTTP 429 レスポンスを処理し、整数の秒数 (10 進数) として設定されるRetry-After レスポンスヘッダー値を尊重することで、可変レート制限に対応する必要があります。この最小時間待機した後に行われたリクエストは、レート制限されなくなります。

または、今後のリクエストの速度を下げる (または遅くする) ことで、レート制限に対応できます。これを実装する一般的な方法は、保留中のリクエストに 1 つまたは複数のキューを使用することです。これは、Notion が HTTP 429 でレスポンスしない限り、リクエストを送信することで消費できます。

🚧レート制限は変更される場合があります

将来、Notion はレート制限を調整して、需要と信頼性のバランスをとる予定です。Notion は、異なる料金プランのワークスペースに個別のレート制限を導入する場合もあります。

サイズ制限

Notion は、特定のパラメーターのサイズと、リクエスト内の子の深さを制限します。これらの制限のいずれかを超えるリクエストは、"validation_error"エラー コード (HTTP レスポンス ステータス 400)を返し、より具体的な詳細が"message"プロパティに含まれます。

インテグレーションでは、これらの制限を超えて積極的にリクエストを送信しないようにする必要があります。エラーが適切に処理されることを確認するために、意図的に大きなパラメーターを含む独自のテスト スイートでテスト データを使用すると役立つ場合があります。たとえば、インテグレーションが外部システムから URL を読み取って Notion ページ プロパティに挿入する場合、インテグレーションは 2000 文字の長さ制限を超える URL を処理する計画を立てる必要があります。インテグレーションは、エラーをログに記録するか、インテグレーションを設定したユーザーに電子メールまたはその他のアクションでアラートを送信することを選択する場合があります。

以下のプロパティ制限に加えて、ペイロードの最大サイズは 1000 ブロック要素で、全体で 500KB であることに注意してください。

プロパティ値の制限

📘リクエスト サイズの制限

これらの制限は、Notion の API に送信されるリクエストのみに適用されます。API によって返されるレスポンスでの関係と人のメンションの数には、さまざまな制限があります。