Elevateword API

Übersicht

Die Elevateword API dient zur Verwaltung von Elevate words (Beeinflussung des Suchrangs für bestimmte Schlüsselwörter) in Fess. Für bestimmte Suchanfragen können Sie bestimmte Dokumente höher oder niedriger platzieren.

Basis-URL

/api/admin/elevateword

Endpunktliste

Methode Pfad Beschreibung
GET /settings Elevate word Liste abrufen
GET /setting/{id} Elevate word abrufen
POST /setting Elevate word erstellen
PUT /setting Elevate word aktualisieren
DELETE /setting/{id} Elevate word löschen
PUT /upload Elevate word CSV hochladen
GET /download Elevate word CSV herunterladen

Elevate word Liste abrufen

Request

GET /api/admin/elevateword/settings

Parameter

Parameter Typ Erforderlich Beschreibung
size Integer Nein Anzahl der Einträge pro Seite (Standard: 20)
page Integer Nein Seitennummer (beginnt bei 1, Standard: 1)
id String Nein Exact-Match-Filter nach Elevate-word-ID

Response

{
  "response": {
    "status": 0,
    "settings": [
      {
        "id": "elevate_id_1",
        "suggestword": "fess",
        "reading": "",
        "permissions": "{role}guest",
        "boost": 100.0,
        "labelTypeIds": []
      }
    ],
    "total": 5
  }
}

Elevate word abrufen

Request

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

Response

{
  "response": {
    "status": 0,
    "setting": {
      "id": "elevate_id_1",
      "suggestword": "fess",
      "reading": "",
      "permissions": "{role}guest",
      "boost": 100.0,
      "labelTypeIds": []
    }
  }
}

Elevate word erstellen

Request

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

Request-Body

{
  "suggestword": "documentation",
  "reading": "",
  "permissions": "{role}guest",
  "boost": 100.0,
  "labelTypeIds": ["label1"]
}

Feldbeschreibungen

Feld Erforderlich Beschreibung
suggestword Ja Das hervorzuhebende Schlüsselwort
reading Nein Lesehilfe (Kana)
permissions Nein Zugriffsberechtigungen (durch Zeilenumbrüche getrennte Zeichenkette, ein Eintrag pro Zeile. Formular-Standardwert: Standard-Anzeigeberechtigung der Suche)
boost Ja Boost-Wert (Formular-Standardwert: 100.0)
labelTypeIds Nein Ziel-Label-IDs (Array von Zeichenketten)

Response

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

Elevate word aktualisieren

Request

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

Request-Body

{
  "id": "existing_elevate_id",
  "suggestword": "documentation",
  "reading": "",
  "permissions": "{role}guest\n{role}user",
  "boost": 100.0,
  "labelTypeIds": ["label1"],
  "versionNo": 1
}

Bemerkung

Bei einer Aktualisierung sind zusätzlich zu den Feldern, die bei der Erstellung verwendet werden, folgende Felder erforderlich:

  • id - ID des zu aktualisierenden Elevate words

  • versionNo - Versionsnummer für optimistisches Sperren. Geben Sie den Wert an, der über GET /setting/{id} abgerufen wurde.

Response

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

Elevate word löschen

Request

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

Response

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

Elevate word CSV hochladen

Registriert Elevate words gesammelt aus einer CSV-Datei. Die Datei wird als multipart/form-data gesendet. Der Import wird serverseitig asynchron ausgeführt.

Request

PUT /api/admin/elevateword/upload
Content-Type: multipart/form-data

Parameter

Parameter Erforderlich Beschreibung
elevatewordFile Ja Hochzuladende Elevate-word-CSV-Datei

Response

{
  "response": {
    "status": 0
  }
}

Elevate word CSV herunterladen

Lädt die registrierten Elevate words als CSV-Datei (elevate.csv) herunter. Die Antwort ist ein Stream vom Typ application/octet-stream.

Request

GET /api/admin/elevateword/download

Verwendungsbeispiele

Produktnamen hervorheben

curl -X POST "http://localhost:8080/api/admin/elevateword/setting" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "suggestword": "Product X",
       "boost": 100.0,
       "permissions": "{role}guest"
     }'

Hervorheben für ein bestimmtes Label

curl -X POST "http://localhost:8080/api/admin/elevateword/setting" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "suggestword": "API reference",
       "boost": 100.0,
       "labelTypeIds": ["technical_docs"],
       "permissions": "{role}guest"
     }'

CSV-Datei hochladen

curl -X PUT "http://localhost:8080/api/admin/elevateword/upload" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -F "elevatewordFile=@elevate.csv"

CSV-Datei herunterladen

curl -X GET "http://localhost:8080/api/admin/elevateword/download" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -o elevate.csv

Referenzinformationen