API LabelType

Vue d’ensemble

L’API LabelType permet de gerer les types de labels de Fess. Vous pouvez manipuler les types de labels utilises pour la classification et le filtrage des resultats de recherche.

URL de base

/api/admin/labeltype

Liste des endpoints

Methode Chemin Description
GET/PUT /settings Obtention de la liste des types de labels
GET /setting/{id} Obtention d’un type de label
POST /setting Creation d’un type de label
PUT /setting Mise a jour d’un type de label
DELETE /setting/{id} Suppression d’un type de label

Obtention de la liste des types de labels

Requete

GET /api/admin/labeltype/settings
PUT /api/admin/labeltype/settings

Parametres

Reponse

{
  "response": {
    "status": 0,
    "settings": [
      {
        "id": "label_id_1",
        "name": "Documentation",
        "value": "docs",
        "includedPaths": ".*docs\\.example\\.com.*",
        "excludedPaths": "",
        "sortOrder": 0
      }
    ],
    "total": 5
  }
}

Obtention d’un type de label

Requete

GET /api/admin/labeltype/setting/{id}

Reponse

{
  "response": {
    "status": 0,
    "setting": {
      "id": "label_id_1",
      "name": "Documentation",
      "value": "docs",
      "includedPaths": ".*docs\\.example\\.com.*",
      "excludedPaths": "",
      "sortOrder": 0,
      "permissions": [],
      "virtualHost": ""
    }
  }
}

Creation d’un type de label

Requete

POST /api/admin/labeltype/setting
Content-Type: application/json

Corps de la requete

{
  "name": "News",
  "value": "news",
  "includedPaths": ".*news\\.example\\.com.*\n.*example\\.com/news/.*",
  "excludedPaths": ".*/(archive|old)/.*",
  "sortOrder": 1,
  "permissions": ["guest"]
}

Description des champs

Reponse

{
  "response": {
    "status": 0,
    "id": "new_label_id",
    "created": true
  }
}

Mise a jour d’un type de label

Requete

PUT /api/admin/labeltype/setting
Content-Type: application/json

Corps de la requete

{
  "id": "existing_label_id",
  "name": "News Articles",
  "value": "news",
  "includedPaths": ".*news\\.example\\.com.*\n.*example\\.com/(news|articles)/.*",
  "excludedPaths": ".*/(archive|old|draft)/.*",
  "sortOrder": 1,
  "permissions": ["guest"],
  "versionNo": 1
}

Reponse

{
  "response": {
    "status": 0,
    "id": "existing_label_id",
    "created": false
  }
}

Suppression d’un type de label

Requete

DELETE /api/admin/labeltype/setting/{id}

Reponse

{
  "response": {
    "status": 0,
    "id": "deleted_label_id",
    "created": false
  }
}

Exemples d’utilisation

Creation d’un label pour la documentation

curl -X POST "http://localhost:8080/api/admin/labeltype/setting" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "Technical Documentation",
       "value": "tech_docs",
       "includedPaths": ".*docs\\.example\\.com.*\n.*example\\.com/documentation/.*",
       "sortOrder": 0,
       "permissions": ["guest"]
     }'

Recherche avec un label

# Filtrage par label
curl "http://localhost:8080/json/?q=search&label=tech_docs"

Informations complementaires