Metainformationen zur Seite
Dies ist eine alte Version des Dokuments!
BeeCollect Cloud API
UpdateData
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-Elemente 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": ""
}