GET suppliers
2024年8月22日
ID 198637
脅威インジケーターとそのステータスのリストを取得します。
REST API を使用して作成された脅威インジケーター、FalsePositive および InternalTI 脅威インジケーターのみが返されます。
パス
/api/%API_VERSION%/suppliers
メソッド
GET
リクエストヘッダー
このリクエストには、次のヘッダーがあります。
リクエストヘッダー
名前 | 値 | 説明 |
---|---|---|
|
| |
|
| レスポンスのコンテンツタイプ。 |
リクエストボディ
このリクエストには、空のボディがあります。
リクエスト例
GET suppliers リクエストの例は、次の通りです。
GET https://192.0.2.57/api/1.1/
Accept: application/json Authorization: Basic |
レスポンスヘッダー
このレスポンスには、次のヘッダーがあります。
レスポンスヘッダー
名前 | 値 | 説明 |
---|---|---|
Content-Type |
| レスポンスのコンテンツタイプ。 |
Content-Length |
| レスポンスボディのサイズ(バイト)。 |
レスポンスボディ
レスポンスボディには、脅威インジケーターステータスオブジェクトの JSON 配列が含まれます。
[
{
"name":"%SUPPLIER_NAME_1%",
"status": "%SUPPLIER_STATUS%"
},
...
{
"name":"%SUPPLIER_NAME_N%",
"status": "%SUPPLIER_STATUS%"
}
]
次の表で脅威インジケーターステータスオブジェクトのプロパティについて説明します。
脅威インジケーターステータスオブジェクトのプロパティ
プロパティ | 値 | 説明 |
---|---|---|
|
| 脅威インジケーターの名前。 |
|
| 脅威インジケーターのステータス。 脅威インジケーターが有効である場合、この値は 脅威インジケーターが無効である場合、この値は |
レスポンス例
GET suppliers リクエストのレスポンス例は、次の通りです。
НТТР/1.1 200 ОК Date:Mon, 23 Dec 2019 09:56:10 UTC Content-Type: application/json Content-Length: 99
[ {"name":"ExampleSupplier", "status":"enabled"}, {"name":"AnotherExampleSupplier", "status":"disabled"} ] |
エラーレスポンス
エラーレスポンスには、レスポンスのステータスに関する情報が含まれます。
エラーレスポンスには、JSON オブジェクトとエラーの説明が含まれます。
[
{
"status": "An error occurred while getting a list of suppliers",
}
]
次の表でエラーオブジェクトのプロパティについて説明します。
エラーオブジェクトのプロパティ
プロパティ | 値 | 説明 |
---|---|---|
|
| エラーの説明。 |
エラーレスポンスの例
GET suppliers エラーのレスポンス例は、次の通りです。
НТТР/1.1 500 Internal Server Error Date:Mon, 23 Dec 2019 09:56:10 UTC Content-Type: application/json Content-Length: 63
[{"status": "An error occurred while getting a list of suppliers"}] |