Entitätseintrag nach ID abrufen

Ruft einen einzelnen Entitätsdatensatz nach ID ab.

API-Endpunkt

BaseURL/EntityService/<Entity>/read/{id}

• BasisURL:

Anforderungsheader

Kopfzeile	Wert
Autorisierung	Bearer <access_token>

Hinweis:

Ersetzen Sie alle Werte zwischen den spitzen Klammern <...> durch die entsprechenden Anwendungsfallwerte.

Die <access_token> ist diejenige, die Sie erhalten haben, als Sie die externe Anwendung autorisiert haben. Es ist 1 Stunde lang verfügbar, dann müssen Sie ein neues generieren oder ein Aktualisierungstoken anfordern.

Pfadvariablen

Pfadvariable	Datentyp	Beschreibung	Standardwert
ID (erforderlich)	string	Die ID des Datensatzes der Entität, den Sie aus dem Data Service abrufen möchten.	Nicht zutreffend

Abfrageparameter

Abfrageparameter	Datentyp	Beschreibung	Standardwert
expansionLevel (optional)	int32	Gibt die Tiefe der abzurufenden Bezugsdatensätze an. Der Wert dieses Parameters kann 1, 2 oder 3 sein.	2

Antworten

200 OK

{
  "ClosingDate": "2021-03-04",
  "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "CreateTime": "2021-03-04T10:20:24.485Z",
  "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "Logo": {
    "Name": "string",
    "Path": "string",
    "Size": 0,
    "Type": "string"
  },
  "Name": "string",
  "Nations": 0,
  "OlymipcsVersion": 0,
  "OpeningDate": "2021-03-04",
  "UpdatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "UpdateTime": "2021-03-04T10:20:24.485Z"
}

401 Nicht autorisiert

Sie sind nicht für den Zugriff auf Data Service authentifiziert. Stellen Sie sicher, dass Ihr Assistent oder Roboter mit einem modernen Ordner in Ihrem Konto verbunden ist.

403 Forbidden

Sie sind nicht berechtigt, auf die Entität, das Feld oder den Datensatz zuzugreifen, oder Sie verwenden einen nicht unterstützten Robotertyp. Wenden Sie sich an Ihren Administrator, um die erforderlichen Berechtigungen zu erhalten.