一般 OData 查詢參數

AppScan 360° API 中最常見的 OData 參數是：

$top

用來限制系統所傳回的記錄數目。只要傳遞整數給它，API 就會採用 $top 值，並且傳回由 $orderby 參數決定的最大數目記錄。例如，如果要傳回前五次掃描：https://cloud.appscan.com/api/v2/Scans?$top=5

$filter

定義要傳回哪些記錄。如果您為這個參數提供運算式，每個記錄都會根據運算式來評估。所有記錄都會評估為 TRUE，讓運算式傳回。這個過濾參數功能非常強大且有用。例如，如果要傳回具有「高風險」評級的所有應用程式：https://cloud.appscan.com/api/V2/Apps?$filter=RiskRating%20eq%20'High'

$select

定義在結果中要包含哪些欄位。當您只對特定欄位感興趣，而且不想要包含其他項目時，這個選項便相當有用。例如，只需要所有應用程式的名稱和建立日期，而不需要其他資訊：https://cloud.appscan.com/api/V2/Apps?$select=Name%2CDateCreated

$skip

定義要略過的記錄數目。例如，如果要列出前兩個原則以外的所有原則：https://cloud.appscan.com/api/V2/Policies?$skip=2

$orderby

定義結果集的順序。您隨著欄位提供此參數，則系統以欄位的順序整理傳回的結果集。如同 SQL 查詢，順序可藉由將 desc 或 asc 附加至參數，決定以遞減或遞增排序。字串欄位會按字母順序排序；數值欄位則是按數字順序排序。您似乎只能在這個參數中提供一個值（即使範例中有兩個值）。例如，如果要傳回所有掃描的清單，請先依據建立日期排序，再依據名稱來排序：https://cloud.appscan.com/api/v2/Scans?$orderby=CreatedAt%20desc