Zum Hauptinhalt springen

Eine Umgebung hinzufügen

Das Hinzufügen einer Umgebung in Aquaware ist ganz einfach und kann entweder über die Aquaware-App oder die API erfolgen.

Umgebung über die App hinzufügen​

Du kannst ganz bequem eine Umgebung über unsere mobile App erstellen, indem du den Bereich „Umgebung hinzufügen“ aufrufst. Damit kannst du dein Aquarium, deinen Teich oder andere Wasserumgebungen direkt von deinem Gerät aus einrichten.

Umgebung über die API hinzufügen​

Wenn du eine Umgebung lieber programmatisch erstellen möchtest, kannst du unseren API-Endpunkt nutzen:

  • URL: https://dev.aquaware.cloud/api/environments/
  • Methode: POST
  • Content-Type: application/json
  • Authentifizierung: Du musst deinen API-Schlüssel mit angeben

Erforderliche Felder​

Beim Erstellen einer Umgebung musst du die folgenden Details angeben:

  • name: Der Name deiner Umgebung (z. B. „Johns Aquarium“).
  • description: Eine kurze Beschreibung der Umgebung (z. B. „Mein Salzwasserriffbecken“).
  • environment_type: Der Typ der Umgebung, den du erstellst. Wähle aus den folgenden Optionen:
    • aquarium
    • pond
    • lake
    • sea
    • pool
    • other
  • city: (Optional) Die Stadt, in der sich die Umgebung befindet.

Beispiel-Request-Body​

{
  "name": "Johns Aquarium",
  "description": "Mein Salzwasserriffbecken",
  "environment_type": "aquarium",
  "city": "New York"
}

Beispielanfrage​

So kannst du eine Umgebung mithilfe der API erstellen:

POST https://dev.aquaware.cloud/api/environments/
X-API-KEY: <dein-api-key>
Content-Type: application/json

Antwort​

Bei Erfolg gibt der Server einen Status 201 Created zurück, zusammen mit Details zur neu erstellten Umgebung.

Wenn du Fragen hast oder Hilfe benötigst, schau dir unsere API-Dokumentation an oder kontaktiere den Support.