{{:beecollect_cloud_250.png?nolink|}}
====== BeeCollect Cloud API ======
== AssignShareKey ==
[[:start|{{ ::icon-home-64.png?nolink|Startseite}}]]
[[:cloud-api|{{ ::icon-arrow-left-64.png?nolink|Zurück zur BeeCollect Cloud API}}]]
=== Beschreibung ===
Ordnet einem DataElement einen übergebenen ShareKey zu.
Diese Aktion ist nur mit dem primären ShareKey des jeweiligen Cores erlaubt.
=== Aufruf ===
https://beecollect.cloud/api/v1/AssignShareKey
=== 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]]) |
| Share-Key | ShareKey, welcher den Zugriff auf die Daten erlaubt (nur der primäre ShareKey des jeweiligen Cores ist hier erlaubt). |
| Data-Element-Key | Gültiger Schlüssel des zu bearbeitenden Daten-Elements als GUID. |
| Assigned-Share-Key | ShareKey, welcher dem DataElement zugewiesen werden soll. |
| Flag | Flag (0 oder 1), welches dem ShareKey zugewiesen werden soll. Das Flag kennzeichnet den Änderungssstatus des Datenelements und kann bei SelectData als Kriterium verwendet werden. |
=== Rückgabewert ===
* JSON-Response
{
"type": "urn:beecollect:success",
"title": "Success",
"status": 200,
"detail": "The request was processed successfully.",
"value": ""
}