指定したタグに関する情報を取得します。
パス
/api/%API_VERSION%/tags/{tag}
メソッド
GET
リクエストヘッダー
このリクエストには、次のヘッダーがあります。
リクエストヘッダー
名前 |
値 |
説明 |
---|---|---|
|
string (base 64) |
|
|
|
レスポンスのコンテンツタイプ。 |
リクエストのパラメータ
このリクエストには、次のパラメータがあります:
リクエストのパラメータ
名前 |
パラメータタイプ |
説明 |
---|---|---|
|
パス |
タグの名前。 |
リクエストボディ
このリクエストには、空のボディがあります。
リクエスト例
GET tags/{tag} リクエストの例は、次の通りです。
GET https://192.0.2.57/api/1.1/tags/WIN-TROJAN
Accept: application/json Authorization: Basic AWxhZGRpbjpvcGVuc2VzYW23 |
レスポンスヘッダー
このレスポンスには、次のヘッダーがあります。
レスポンスヘッダー
名前 |
値 |
説明 |
---|---|---|
Content-Type |
|
レスポンスのコンテンツタイプ。 |
Content-Length |
integer |
レスポンスボディのサイズ(バイト)。 |
レスポンスボディ
このレスポンスボディには、JSON 配列とタグオブジェクトが含まれます。
[
{
"name": "%TAG_NAME%",
"weight": %TAG_WEIGHT%
}
]
次の表でタグオブジェクトのプロパティについて説明します。
タグオブジェクトのプロパティ
プロパティ |
値 |
説明 |
---|---|---|
|
文字列 |
タグの名前。 |
|
整数 |
タグの重要性( |
レスポンス例
GET tags/{tag} リクエストのレスポンスの例は、次の通りです。
НТТР/1.1 200 ОК Date:Mon, 23 Dec 2019 09:56:10 UTC Content-Type: application/json Content-Length: 150
[ { "name": "WIN-TROJAN", "weight": 5 } ] |
エラーレスポンス
エラーレスポンスには、レスポンスのステータスに関する情報が含まれます。
エラーレスポンスには、JSON オブジェクトとエラーの説明が含まれます。
[
{
"status": "An error occurred while getting tag info",
"reason": "Tag doesn't exist"
}
]
次の表でエラーオブジェクトのプロパティについて説明します。
エラーオブジェクトのプロパティ
プロパティ |
値 |
説明 |
---|---|---|
|
文字列 |
エラーの説明。 |
|
文字列 |
エラーの理由。 このプロパティは欠落している場合があります。 |
エラーレスポンスの例
GET tags/{tag} リクエストのエラーレスポンスの例は、次の通りです。
НТТР/1.1 404 Tag doesn't exist Date:Mon, 23 Dec 2019 09:56:10 UTC Content-Type: application/json Content-Length: 150
[ { "status": "An error occurred while getting tag info", "reason": "Tag doesn't exist" } ] |