Edit the URL of a specified URL Category

Note: Before you use this API, make sure to create the URL Categories override file by copying the file /usr/share/fa/data/plugins/panorama/url_categories.json to this location: /home/afa/.fa/plugins/panorama/.

Edit the URL of a specified URL Category in the URL Categories override file. Currently only Panorama devices are supported. Use the URL-categories-controller API GET /{category} method to return the list of available URL Categories.

For further information about the URL Categories override file see (optional) Enhance URL Category accuracy.

Resource Name: /api/v1/plugins/{brand}/URLcategory/{category}/URL/{url}

Request Method: PUT

Request URL Parameters:

Element

Type

Description

brand
Mandatory

string

Brand name code. Only "panorama" is supported.

category
Mandatory

string Specified URL Category name
url
Mandatory
string URL to be changed

Request Body Parameters:

Element

Type

Description

Body
Mandatory

string

JSON string of the New URL.

for example:

Copy
 "www.nba1.com" 

Response parameters

Element

Type

Description

categories map of objects

The list of URL categories, each populated by:

  • URL Category name

  • URLs and their IPs

Response:

Status codes:

Code

Description

200

ActiveChange was triggered

400

Input validation failure

403

Authentication failure

500

Failed to complete operation.

Request cURL examples

curl -X PUT "https://localhost/afa/api/v1/plugins/panorama/URLCategory/sports/URL/www.nba.com/" -H "accept: */*" -H "Content-Type: application/json" -d "www.nba1.com" 

Response example for 200

Copy
{
  "categories": {
    "search-engines": {
        "www.bing.com": [
          "204.79.197.200",
          "13.107.21.200"
        ],
        "www.google.com": [
          "172.217.19.132",
          "172.217.18.100"
        ]
      },
      "sports": {
        "urls": {
          "www.nba1.com": [
            "104.106.236.138",
            "92.122.144.117"
          ]
        }
      }
    }
}