Artica includes a fully documented REST API that lets you start, stop, configure, and monitor the web‐filtering daemon remotely.
Any action you would normally perform in the web console—such as enabling or disabling categories, updating filter rules, or reloading the filter engine—can be executed by sending an HTTP request to the appropriate API endpoint.
This makes it possible to integrate Artica’s web‐filtering controls into external automation scripts, orchestration tools, or custom dashboards without needing to log in to the GUI.
This feature is available on Artica v4.50 Service Pack 5 or Artica v4.50 Service Pack 4 Hotfix 20250605-13
GET http://1.2.3.4:9503/webfilter/rules/compile
command-line: artica-phpfpm-service -rest-api /webfilter/rules/compile
When you add sites to your personal categories, you need to compile those categories and apply the filtering rules.
Your new site will then be incorporated and active in the rules within a few minutes.
This batch operation is designed to speed up the process by performing all steps at once.
To add websites to a category, you first need to know its identifier.
You can retrieve this by calling the API that lists your personal categories—each category’s ID is provided in the category_id
field.
Once you have that ID, use the category-enrichment API to add your site.
GET http://1.2.3.4:9503/categories/list
command-line: artica-phpfpm-service -rest-api /categories/list
{
"Status": true,
"Error": "",
"Categories": [
{
"table_name": "",
"category_name": "github1",
"category_id": 252,
"rpz_enabled": 0,
"rpz_action": 2,
"rpz_redirect": ""
}
}
PUT http://1.2.3.4:9503/categories/quick/[ID]
use items
as name field
command-line:= artica-phpfpm-service -rest-api-put /categories/quick/252 -value items=esperanza.pl,svekrovi.net,gospmr.org,3dvsem.com,skiokz.com,tomlankhorst.nl
curl example:
curl -X PUT http://1.2.3.4:9503categories/quick/252 -d "items==esperanza.pl,svekrovi.net,gospmr.org,3dvsem.com,skiokz.com,tomlankhorst.nl"