„api v1 share get_de“ ändern

mpeltriaux 2022-02-16 11:23:40 +01:00
parent cb466000a9
commit 643753b09e

@ -1,4 +1,27 @@
## Spezifikation ## Spezifikation
### GET Response allgemein
Jeder erfolgreiche `GET` Request wird mit folgender Response Struktur beantwortet:
```json
{
"rpp": 5,
"p": 1,
"next": "http://example.org/api/v1/xyz/?rpp=5&p=2",
"results": {
...
}
}
```
Erklärung:
* `rpp`: Results per page. Bestimmt wie viele Ergebnisse pro Seite zurückgeliefert werden
* `p`: Page. Gibt die zurückgelieferte Seitennummer an
* `next`: URL zur nächsten Seite. Sollte keine weitere Seite existieren wird hier `null` stehen
* `results`: Die angefragten Daten.
* Alle folgenden Response Beispiele beziehen sich auf den Inhalt von `results`
Request Parameter:
* `rpp`: Kann direkt als `GET` Parameter im Request mitgegeben werden (s. `next` URL). Muss eine Zahl > 0 sein. Falls nicht angegeben, wird ein Standardwert verwendet
* `p`: Kann direkt als `GET` Parameter im Request mitgegeben werden (s. `next` URL). Muss eine Zahl > 0 sein. Falls nicht angegeben, wird ein Standardwert verwendet
### Eingriff, Ökokonto, EMA ### 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.* *Die Freigabe von Eingriffen an bestimmte Nutzer vererbt auch die Freigabe der zugehörigen Kompensationen. Eine separate Freigabe je Kompensation ist nicht notwendig.*