<WRAP group>
<WRAP box>
<WRAP left>
{{:beecollect_cloud_250.png?nolink|}}
</WRAP>
<WRAP left>
====== BeeCollect Cloud API ======
== RequestShareKey ==
</WRAP>
</WRAP>
</WRAP>

<WRAP group>
<WRAP column right>
[[:start|{{ ::icon-home-64.png?nolink|Startseite}}]]
[[:cloud-api|{{ ::icon-arrow-left-64.png?nolink|Zurück zur BeeCollect Cloud API}}]]
</WRAP>
<WRAP twothirds column>

=== Beschreibung ===
Fordert einen ShareKey für die angegebene Organisation an, welcher Zugriff auf eigene Daten mit den angegebenen Rechten gewährt. Für jede Organisation kann jeweils nur ein ShareKey angefordert werden. Existiert bereits ein ShareKey für die angegebene Organisation, wird dieser entsprechend den hier angegebenen Rechten modifiziert. 

=== Aufruf ===

<code>
https://beecollect.cloud/api/v1/RequestShareKey
</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)  |
| Read                       | Organisation erhält / erhält keine Lese-Rechte über den ShareKey (true/false)              |
| Write                      | Organisation erhält / erhält keine Schreib-Rechte über den ShareKey (true/false)           |
| Insert                     | Organisation erhält / erhält keine Einfüge-Rechte über den ShareKey (true/false). Dies meint das Hochladen neuer Daten-Elemente.  |
| Delete                     | Organisation erhält / erhält keine Lösch-Rechte über den ShareKey (true/false)             |

=== Rückgabewert ===
  * JSON-Response

<code>
{
  "ShareKey": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "OwnerOrganisationKey": "string",
  "OwnerOrganisation": "string",
  "GrantedOrganisationKey": "string",
  "GrantedOrganisation": "string",
  "IsPrimary": true,
  "Read": true,
  "Write": true,
  "Insert": true,
  "Delete": true
}
</code>

</WRAP>
</WRAP>