自動で適用される制限

リクエストレート

各APIキーには1時間あたりのリクエスト許容量があり、その量はプランで決まります。許容量はそのキーだけのもので、スライディング60分で計測されます。単位は1回のHTTPリクエストで、返すレコード数は問いません。5,000を超えるフィールドを選択するドキュメントは、その比率で課金されます。すべてのレスポンスは、上限、残り、リセット時刻をヘッダーで報告します。

上限を超えたとき

拒否されたリクエストにはHTTP 429が返り、コードはRATE_LIMITEDで、Retry-Afterヘッダーが付きます。型付きSDKは、リトライするときにこのヘッダーに従います。

上限を超えたGraphQLエンドポイントへの読み取りは、まったく同じリクエストのキャッシュ済みレスポンスがある場合、レスポンスキャッシュから応答されます。応答はHTTP 200で、ヘッダーX-Foir-Stale: trueが付きます。キャッシュのない読み取りには429が返ります。

クエリのサイズ

実行前にパース済みのドキュメントに対して、3つの上限が適用されます。深さは最大24、複雑度は選択フィールド数で最大10,000、エイリアスは最大1,000です。複雑度は単純な数え上げです。選択された各フィールドが1として数えられ、フィールドごとの重みも、リストによる乗算もなく、ユニオンは最大のメンバーで課金されます。3つの上限はレスポンスヘッダーでも通知されます。

同時リクエスト

ワークスペースでは、数十件のリクエストを同時に実行できます。それを1件でも超えると、キューに入れられずに、同じレート制限コードで即座に拒否されます。