Skip to content
Pro
ドキュメントのセクション

バッチ

POSThttps://rftools.io/api/py/v1/calculate/batch

1 リクエストで最大 50 件の計算を、計算ツールを自由に組み合わせて実行できます。パラメーターの掃引や、1 つの設計の数値をまとめて求めるのに使います。各項目は /calculate とまったく同じように計算されます。

バッチエンドポイントは API プランに含まれます。計算した各項目が 1 回の呼び出しとして計上され、計算前に拒否された項目は費用がかかりません。

リクエストボディ

BatchRequest
フィールド説明
calculations必須array1〜50 件の項目。各項目は /calculate が受け付けるのと同じ {slug, inputs} です。これを超えると、上限を示して 400 で拒否されます。

レスポンス

BatchResponse
フィールド説明
resultsarray計算ごとに 1 項目、順番どおり。
results[].slugstringその項目の計算ツール。
results[].values, warnings, errors, provenanceas /calculate計算された項目：/calculate がその項目に対して返すものと同一。
results[].error, errorKindstring計算されなかった項目：その理由（存在しないスラッグ、有限の数でない入力）。計上はされていません。

結果はリクエストと同じ順に並びます。各項目を確認してください。計算された項目には values と provenance が、計算されなかった項目には error と errorKind があります。1 つの項目の失敗が、ほかの項目を失敗させることはありません。

拒否

  • 400：計算がないか（At least one calculation is required）、50 件を超えています。上限が示されます。
  • 401：キーがないか、無効なキーです。
  • 402：計算する項目の分の利用枠が残っていません。計上はされていません。
  • 403：アカウントのプランにバッチの利用が含まれていません。ボディに、それを含むプランが示されます。