102 lines
2.3 KiB
Markdown
102 lines
2.3 KiB
Markdown
# 📡 Webservices – TALAS / GIS
|
||
|
||
## Basis-URL
|
||
|
||
```env
|
||
NEXT_PUBLIC_API_BASE_URL=http://[DNS-Name-oder-IP]/[pfad]
|
||
# Beispiel: http://10.10.0.13/talas5/ClientData/WebServiceMap.asmx
|
||
```
|
||
|
||
---
|
||
|
||
## Endpunkte
|
||
|
||
### 1. `GisStationsStatic`
|
||
|
||
- **Beschreibung:** Statische Geräteliste einer Karte
|
||
- **Methode:** GET
|
||
- **Parameter:** `idMap`
|
||
- **Beispiel:**
|
||
|
||
```
|
||
GET /GisStationsStatic?idMap=12
|
||
http://10.10.0.13/talas5/ClientData/WebServiceMap.asmx/GisStationsStatic?idMap=12
|
||
|
||
```
|
||
|
||
---
|
||
|
||
### 2. `GisStationsStaticDistrict`
|
||
|
||
- **Beschreibung:** Statische Geräte inkl. Bereichszuordnung
|
||
- **Methode:** GET
|
||
- **Parameter:** `idMap`, `idUser`
|
||
- **Beispiel:**
|
||
```
|
||
GET /GisStationsStaticDistrict?idMap=12&idUser=484
|
||
http://10.10.0.13/talas5/ClientData/WebServiceMap.asmx/GisStationsStaticDistrict?idMap=12&idUser=484
|
||
```
|
||
|
||
---
|
||
|
||
### 3. `GisStationsStatusDistrict`
|
||
|
||
- **Beschreibung:** Aktueller Status von Geräten im Gebiet
|
||
- **Methode:** GET
|
||
- **Parameter:** `idMap`, `idUser`
|
||
- **Beispiel:**
|
||
```
|
||
GET /GisStationsStatusDistrict?idMap=12&idUser=484
|
||
http://10.10.0.13/talas5/ClientData/WebServiceMap.asmx/GisStationsStatusDistrict?idMap=12&idUser=484
|
||
```
|
||
|
||
---
|
||
|
||
### 4. `GisStationsMeasurements`
|
||
|
||
- **Beschreibung:** Live-Messwerte der Geräte
|
||
- **Methode:** GET
|
||
- **Parameter:** `idMap`, `idUser`
|
||
- **Beispiel:**
|
||
```
|
||
GET /GisStationsMeasurements?idMap=12&idUser=484
|
||
http://10.10.0.13/talas5/ClientData/WebServiceMap.asmx/GisStationsMeasurements?idMap=12&idUser=484
|
||
```
|
||
|
||
---
|
||
|
||
### 5. `GisSystemStatic`
|
||
|
||
- **Beschreibung:** Liste aller Systeme auf der Karte
|
||
- **Methode:** GET
|
||
- **Parameter:** `idMap`, `idUser`
|
||
- **Beispiel:**
|
||
```
|
||
GET /GisSystemStatic?idMap=12&idUser=484
|
||
http://10.10.0.13/talas5/ClientData/WebServiceMap.asmx/GisSystemStatic?idMap=12&idUser=484
|
||
```
|
||
|
||
---
|
||
|
||
## Nutzung im Code
|
||
|
||
- Alle Webservice-Aufrufe basieren auf:
|
||
```js
|
||
const apiBaseUrl = process.env.NEXT_PUBLIC_API_BASE_URL;
|
||
```
|
||
- Fallback-IDs über `.env.local`:
|
||
```env
|
||
NEXT_PUBLIC_DEFAULT_ID_MAP=12
|
||
NEXT_PUBLIC_DEFAULT_ID_USER=484
|
||
```
|
||
|
||
---
|
||
|
||
## Hinweise
|
||
|
||
- ❌ Keine festen IPs/Domains in Code-Dateien verwenden
|
||
- ✅ Nur `.env.local` als zentrale Konfiguration nutzen
|
||
- ✅ Beispielaufrufe ausschließlich in dieser Datei dokumentieren
|
||
- ✅ Webservice-Funktionen befinden sich in:
|
||
`/redux/api/fromWebService/fetchGis*.js`
|