„api-v1-share_de“ hinzufügen

api-v1-share_de.md

@@ -0,0 +1,45 @@
+## Spezifikation
+### Eingriff, Ökokonto, EMA
+
+*Die Freigabe von Eingriffen an bestimmte Nutzer vererbt auch die Freigabe der zugehörigen Kompensationen. Eine separate Freigabe je Kompensation ist nicht notwendig.* 
+
+#### PUT
+Mit `PUT` können die Freigabeeinstellungen eines Eintrags angepasst werden. 
+
+**Achtung:** Wenn Sie **nur über die Gruppe Standard** verfügen, können Sie nur neue Nutzer hinzufügen, jedoch keine bereits bestehenden entfernen. Hierzu sind die Rechte der Gruppe `Zulassungsbehörde` oder `Eintragungsstelle` notwendig. Falls `user1` also schon eine Freigabe erteilt bekommen hat und Sie senden seinen Nutzernamen in einem `PUT` request nicht mit, wird die Freigabe für `user1` nicht entzogen!
+
+Die folgenden URLS können zur Anpassung der Nutzerfreigabe auf den jeweiligen Eintrag eines Datentyps verwendet werden:
+
+```
+/api/v1/intervention/<uuid>/share
+```
+```
+/api/v1/ecoaccount/<uuid>/share
+```
+```
+/api/v1/ema/<uuid>/share
+```
+
+#### Beispiel Body
+    
+```json
+{
+    "users": [
+        "user1",
+        "user2",
+        "user3"
+    ]
+}
+    
+```
+    
+
+
+
+#### Beispiel Response
+```json
+{
+    "success": true
+}
+    
+```