Metainformationen zur Seite
  •  

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Nächste Überarbeitung		Vorhergehende Überarbeitung
cloud-api:endpoints:v1:updatedata [2025/12/02 14:50] – angelegt bcadmincloud-api:endpoints:v1:updatedata [2025/12/11 10:24] (aktuell) – bcadmin
Zeile 18: Zeile 18:
 <WRAP twothirds column> <WRAP twothirds column>
  
 +=== 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 ===
 +
 +<code>
 +https://beecollect.cloud/api/v1/UpdateData
 +</code>
 +
 +=== 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 [[cloud-api:endpoints:v1:getaccesstoken|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
 +
 +<code>
 +{
 +  "type": "urn:beecollect:success",
 +  "title": "Success",
 +  "status": 200,
 +  "detail": "The request was processed successfully.",
 +  "value": ""
 +}
 +</code>
  
 </WRAP> </WRAP>
 </WRAP> </WRAP>
↑