Skip to content

gs_rest_categories.php

URL zum Abruf von Objekt-IDs zu bestimmten Kategorien.

Aufruf per URL

<!-- Listenabfrage -->
http://localhost/gris/api/v1/de/category/person/[23,211]
http://localhost/gris/api/v1/de/category/project/[23,211]
http://localhost/gris/api/v1/de/category/resource/[23,211]

<!-- Detailabfrage -->
http://localhost/gris/api/v1/de/category/person/[23,211]/all
http://localhost/gris/api/v1/de/category/project/[23,211]/all
http://localhost/gris/api/v1/de/category/resource/[23,211]/all

<!-- Detailabfrage mit Zeitraum -->
http://localhost/gris/api/v1/de/category/project/[3,23]/all/range/2021-2023
http://localhost/gris/api/v1/de/category/resource/[23,211]/all  

<!-- Verwendete Kategorien -->
http://localhost/gris/api/v1/de/category/person/list
http://localhost/gris/api/v1/de/category/project/list
http://localhost/gris/api/v1/de/category/resource/list

Die Zahlen (eine oder mehrere durch Komma getrennt) geben die Kategorien an.

Hinweis

Anstatt der IDs bzw. der ID-Liste kann der Parameter list verwendet werden, um alle benutzten Kategorien zu dieser Objektgruppe anzuzeigen. Wird am Ende der URL der Zusatz all hinzugefügt, werden neben den IDs auch die Inhalte zurückgegeben.

Rewrite Regeln

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(de|en)\/category\/(person|project|resource)\/(\[[,0-9]+\]|(list))?(\/(all)?)?(\/(range\/((19|20)\d{2}(-(19|20)\d{2})?))?)?$ gs_rest_categories.php?lang=$1&type=$2&categories=$3&param=$6&range=$9 [NC,L,QSA]

Pfad-Parameter

Beschreibung Name Wertebereich Anmerkungen
Sprache lang de | en Übersetzungen müssen Ansonsten wird de als Fallback ausgegeben.
Kategorien categories JSON mit IDs oder list (String) Bei list werden alle verwendeten Kategorien zum Objekt ausgegeben
Objekttyp type person | project | resource
Alle Daten param all Alle Detailinformationen ausgeben
Zeitrahmen range range Jahr (2029) oder Zeitraum wählen (2020-2024)

GET-Parameter

Namer Parameter Datentyp Anmerkungen
Offset offset Integer Der Offset-Wert (Integer) für die Treffer
Limit limit Integer Die Anzahl (Integer) der zurückgegebenen Treffer

Methoden

GET

Antwort

Eine Liste mit den IDs der jeweiligen Objekte.

{
  "message": {
      "status": "SUCCESS GET",
      "total": 3
  },
  "data": [
    "14262",
    "14253",
    "13895"
  ]
}

Beispiel mit dem Zusatz /list

{
  "message": {
      "status": "SUCCESS GET",
      "total": 25
  },
  "data": {
      "3": "Stellenangebote",
      "22": "GLES",
      "23": "Angewandte Informatik",
      "183": "Public and Organizational Policies",
      "...": "...",
      "211": "Forschung",
      "228": "Wissenstransfer"
  }
}

Beispiel mit dem Zusatz /all

{
  "message": {
      "status": "SUCCESS GET",
      "total": 3
  },
  "data": {
    "Zitation 1",
    "Zitation 2",
    "Zitation 3"
  }
}

PUT

Nicht verfügbar

POST

Nicht verfügbar

DELETE

Nicht verfügbar