Metainformationen zur Seite
  •  

BeeCollect Cloud API

UpdateData

Startseite Zurück zur BeeCollect Cloud API

Beschreibung

Aktualisiert ein Daten-Element im mit dem ShareKey assoziierten Core.

Ist das entsprechende Datenelement im Core noch nicht vorhanden, wird es angelegt.

Ist das Datenelement im Core bereits vorhanden, wird es überschrieben. Die Aktion setzt voraus, dass der ShareKey Schreibrechte auf den Core und das Element gewährt, falls es bereits existiert, bzw. Einfügerechte auf den Core, falls es noch nicht existiert.

Bei bereits vorhandenen Daten-Elementen bleiben die bereits zugeordneten ShareKeys erhalten, es wird jedoch automatisch bei allen ShareKeys das Flag gesetzt. Bei neu angelegten Daten-Elementen wird lediglich der übergebene ShareKey zugeordnet.

Ist dieser ShareKey nicht identisch mit dem primären ShareKey der Organisation, welcher der Core zugeordnet ist (beim Einfügen von Daten in Cores anderer Organisationen) wird auch der primäre ShareKey dieser Organisation zugeordnet (sonst wäre nicht sichergestellt, dass die Organisation Zugriff auf alle Daten ihres Cores hat).

Ist das Daten-Element bereits vorhanden, ist jedoch mit dem Deleted-Flag gekennzeichnet, wird dieses zurückgesetzt und die Daten-Struktur des Elementes wieder gefüllt.

Aufruf

https://beecollect.cloud/api/v1/UpdateData

Methode

  • POST

Authentifizierung

  • HTTP Basic Auth (Benutzer und Kennwort wird von Solvatec bereitgestellt)
  • X-Access-Token Header

Parameter

Alle Parameter werden als benannte Header erwartet.

Parameter Beschreibung
X-Access-Token Gültiges Access-Token (siehe GetAccessToken)
Organisation-Key Gültiger Schlüssel der Organisation, mit der Daten geteilt werden sollen (wird von der jeweiligen Organisation bereitgestellt)
Share-Key ShareKey, welcher den Zugriff auf die Daten erlaubt.

Rückgabewert

  • JSON-Response
{
  "type": "urn:beecollect:success",
  "title": "Success",
  "status": 200,
  "detail": "The request was processed successfully.",
  "value": ""
}