Skip to content

gs_rest_objects.php

URL zum Abruf von Einzelobjekten per ID.

Aufruf per URL

http://localhost/gris/api/v1/de/object/personname/12
http://localhost/gris/api/v1/de/object/person/12
http://localhost/gris/api/v1/de/object/person/12/all
http://localhost/gris/api/v1/de/object/person/mailpraefix
http://localhost/gris/api/v1/de/object/person/mailpraefix/all
http://localhost/gris/api/v1/de/object/project/12
http://localhost/gris/api/v1/de/object/resource/12
http://localhost/gris/api/v1/de/object/institute/12

Die Zahl gibt jeweils die ID an. Mit der ID 0 kann bei project und institute auch die gesamte Liste abgerufen werden. Je nach Objekttyp können dadurch jedoch große Datenmengen und längere Verarbeitungszeiten anfallen. Für Listen sollte normalerwesie gs_rest_lists verwendet werden.

Für den Abruf von Personen object/person steht zuätzlich der Parameter all zur Verfügung, um auch die zugeordneten Publikationen in die JSON-Rückgabe einzubinden.

Rewrite Regeln

RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(de|en)\/object\/(personname|person|project|resource|institute)\/([0-9\*]+|[a-zA-Z0-9._%+-]+)(\/(all)+)*$ gs_rest_objects.php?lang=$1&type=$2&id=$3&param=$5 [NC,L]

Parameter

Beschreibung Name Wertebereich Anmerkungen
Sprache lang de | en Übersetzungen müssen vorhanden sein. Ansonsten wird de als Fallback ausgegeben.
Objekttyp type personname | person | project | resource | institute
Objekt-ID id Integer (bei person auch String) Mit der ID 0 kann bei project und institute auch die gesamte Liste abgerufen werden. Bei person kann alternativ auch der Mailpräfix verwendet werden.
Alle Publikationen param all Ist nur für person gültig

Methoden

GET

Antwort

Das gewünschte Objekt als JSON.

Antwort von personname

{
  "message": "SUCCESS GET",
  "data": {
    "gris_personname_id": "12",
    "gris_person_id": "12",
    "gris_personname_name": "Doe",
    "gris_personname_firstname": "John",
    "gris_personname_email": "john.doe@nowhere.com",
    "gris_personname_order": "0",
    "gris_personname_title_before": "",
    "gris_personname_title_after": null,
    "gris_personname_external": "0",
    "delete_3p_person_id": null
  }
}

Antwort von person

{
  "message": "SUCCESS GET",
  "data": {
    "gris_person_id": 60,
    "gris_person_orcid": "xyz",
    "gris_person_internal_id": "erererer",
    "gris_institute_id": "1",
    "gris_person_is_student": "0",
    "gris_person_is_alumni": "0",
    "gris_person_room": "A520",
    "gris_person_phone": "137",
    "gris_person_fax": "199",
    "gris_person_gender": "m",
    "gris_person_url": null,
    "gris_person_cv": null,
    "gris_person_oa": "0",
    "gris_person_graduate_area": null,
    "gris_person_show": "1",
    "gris_personname": [
      {
        "gris_personname_id": "60",
        "gris_person_id": "60",
        "gris_personname_name": "Heuser",
        "gris_personname_firstname": "Holger",
        "gris_personname_email": "holger.heuser@gesis.org",
        "gris_personname_order": "0",
        "gris_personname_title_before": "",
        "gris_personname_title_after": null,
        "gris_personname_external": "0",
        "delete_3p_person_id": null
      }
    ],
    "gris_institute": {
      "gris_institute_id": "1",
      "gris_institute_phone": "47694",
      "gris_address_id": "1",
      "gris_institute_acronym": null,
      "gris_institute_name": "GESIS - Leibniz-Institut für Sozialwissenschaften",
      "gris_institute_url": "http://www.gesis.org",
      "gris_institute_internal": "1",
      "gris_clean": "1",
      "gris_institute_fax": "199",
      "gris_institute_basephone": "0",
      "gris_address": {
        "gris_city_id": "1",
        "gris_address_street": "Unter Sachsenhausen",
        "gris_address_streetnumber": "6-8",
        "gris_clean": "1",
        "gris_city": {
          "gris_city_name": "Köln",
          "gris_city_postalcode": "50667",
          "gris_city_areacode": "0221",
          "gris_city_countrycode": "49",
          "gris_city_country": null,
          "gris_clean": "1"
        }
      }
    },
    "gris_units": [
      {
        "gris_unit_id": "1",
        "gris_unit_name": "Präsident",
        "gris_unit_acronym": null,
        "gris_unit_type": "Präsident",
        "gris_unit_parent_id": "0",
        "gris_unit_deprecated": "0",
        "subunits": [
          {
            "gris_unit_id": "42",
            "gris_unit_name": "Persönliche Referentin",
            "gris_unit_acronym": null,
            "gris_unit_type": "Team",
            "gris_unit_parent_id": "1",
            "gris_unit_deprecated": "0",
            "subunits": null,
            "hit": true,
            "gris_organigram_role": "Mitarbeiter"
          },
          {
            "gris_unit_id": "55",
            "gris_unit_name": "Wissenstransfer",
            "gris_unit_acronym": null,
            "gris_unit_type": "Stabsabteilung",
            "gris_unit_parent_id": "1",
            "gris_unit_deprecated": "0",
            "subunits": [
              {
                "gris_unit_id": "3",
                "gris_unit_name": "Kommunikation",
                "gris_unit_acronym": null,
                "gris_unit_type": "Team",
                "gris_unit_parent_id": "55",
                "gris_unit_deprecated": "0",
                "subunits": null,
                "hit": true,
                "gris_organigram_role": "Stellvertretender Teamleiter"
              }
            ],
            "hit": false
          }
        ],
        "hit": false
      }
    ],
    "gris_persontext": {
      "gris_vita": {
        "de": "Text de",
        "en": "Text en"
      }
    }
  }
}

Antwort von project

{

  "message": "SUCCESS GET",
  "data": {
    "gris_project_show": "0",
    "gris_project_type": "Drittmittelprojekt",
    "gris_project_sponsor": "Bund",
    "gris_project_code": "xyz",
    "gris_project_title": " Projektname",
    "gris_project_subtitle": "...",
    "gris_project_acronym": "XYZ",
    "gris_project_generic_mail": null,
    "gris_project_start": "01.01.2017",
    "gris_project_end": "31.12.2020",
    "gris_relations": {
      "Leitung": [
        {
          "gris_relations_id": "37",
          "gris_relations_subject_table": "gris_personname",
          "gris_relations_subject_id": "412",
          "gris_relations_value": "0",
          "gris_relations_percentage": "0"
        }
      ],
      "Mitarbeitende": [
        {
          "gris_relations_id": "38",
          "gris_relations_subject_table": "gris_personname",
          "gris_relations_subject_id": "357",
          "gris_relations_value": "0",
          "gris_relations_percentage": "0"
        }
      ]
    },
    "gris_texts": [ ],
    "gris_project_id": 12
  }
}

Antwort von resource

{
  "message": "SUCCESS GET",
  "data": {
      "gris_citation": "Bandilla, Wolfgang, Wolfgang Jagodzinski, Pascal Siegers, and Matthias Stahl. 2008. <em>Befragung der Professoren und Mitarbeiter der politischen Wissenschaften</em>. GESIS-Arbeitsbericht 2008/06. Bonn: GESIS. <a href='http://www.gesis.org/fileadmin/upload/forschung/publikationen/gesis_reihen/gesis_arbeitsberichte/GESIS_AB_6.pdf' target='_blank'>http://www.gesis.org/fileadmin/upload/forschung/publikationen/gesis_reihen/gesis_arbeitsberichte/GESIS_AB_6.pdf</a>. ",
      "gris_resource_id": 12
  }
}

Antwort von institute

{
  "message": "SUCCESS GET",
  "data": {
      "gris_institute_id": 151,
      "gris_institute_phone": null,
      "gris_address_id": "72",
      "gris_institute_acronym": null,
      "gris_institute_name": "GESIS",
      "gris_institute_url": "",
      "gris_institute_internal": null,
      "gris_clean": null,
      "gris_institute_fax": null,
      "gris_institute_basephone": null,
      "gris_address": {
          "gris_city_id": null,
          "gris_address_street": "",
          "gris_address_streetnumber": "",
          "gris_clean": null,
          "gris_city": {
              "gris_city_name": null,
              "gris_city_postalcode": null,
              "gris_city_areacode": null,
              "gris_city_countrycode": null,
              "gris_city_country": null,
              "gris_clean": null
          }
      }
  }
}

PUT

Nicht verfügbar

POST

Nicht verfügbar

DELETE

Nicht verfügbar