refactor+docs: fetchGisStatusStations.js URL-Handling vereinheitlicht (v1.1.78)
- entfernt: NEXT_PUBLIC_SERVER_URL aus fetchGisStatusStations.js - ersetzt durch dynamischen URL-Aufbau via NEXT_PUBLIC_API_PORT_MODE - neue Doku erstellt: docs/frontend/services/api/fetchGisStatusStations.md - CHANGELOG.md aktualisiert (v1.1.78)
This commit is contained in:
84
docs/frontend/services/api/fetchGisStatusStations.md
Normal file
84
docs/frontend/services/api/fetchGisStatusStations.md
Normal file
@@ -0,0 +1,84 @@
|
||||
# 🛰️ fetchGisStatusStations – Geräte-Statusdaten abrufen
|
||||
|
||||
## Zweck
|
||||
|
||||
Diese Funktion ruft den aktuellen Status aller Stationen (Geräte) für eine bestimmte Karte ab.
|
||||
Sie basiert auf dem Webservice `GisStationsStatusDistrict`.
|
||||
|
||||
---
|
||||
|
||||
## Webservice-Endpunkt
|
||||
|
||||
```
|
||||
GET /talas5/ClientData/WebServiceMap.asmx/GisStationsStatusDistrict?idMap={idMap}&idUser={idUser}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Dynamische URL-Erzeugung
|
||||
|
||||
Die Funktion nutzt **keine feste URL** aus `.env.local`, sondern erkennt die Umgebung anhand von:
|
||||
|
||||
```env
|
||||
NEXT_PUBLIC_API_PORT_MODE=dev
|
||||
```
|
||||
|
||||
### Beispiel aus dem Code:
|
||||
|
||||
```js
|
||||
const mode = process.env.NEXT_PUBLIC_API_PORT_MODE;
|
||||
|
||||
const SERVER_URL =
|
||||
mode === "dev"
|
||||
? \`\${window.location.protocol}//\${window.location.hostname}:80\`
|
||||
: \`\${window.location.origin}\`;
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Parameter
|
||||
|
||||
| Name | Typ | Beschreibung |
|
||||
|----------|--------|--------------------------|
|
||||
| `idMap` | string | Karten-ID |
|
||||
| `idUser` | string | Benutzer-ID |
|
||||
|
||||
---
|
||||
|
||||
## Verwendung
|
||||
|
||||
Die Funktion nutzt `fetchWithTimeout` mit einem Timeout von 5000 ms.
|
||||
|
||||
```js
|
||||
fetchWithTimeout(
|
||||
\`\${SERVER_URL}/talas5/ClientData/WebServiceMap.asmx/GisStationsStatusDistrict?idMap=\${idMap}&idUser=\${idUser}\`,
|
||||
{ method: "GET", headers: { Connection: "close" } },
|
||||
5000
|
||||
)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Fehlerbehandlung
|
||||
|
||||
Bei HTTP-Fehlern oder Zeitüberschreitung wird ein Fehler geloggt und erneut geworfen.
|
||||
|
||||
```js
|
||||
if (!response.ok) throw new Error(...);
|
||||
.catch((error) => {
|
||||
console.error(...);
|
||||
throw error;
|
||||
});
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Siehe auch
|
||||
|
||||
- `.env.local` → `NEXT_PUBLIC_API_PORT_MODE`
|
||||
- `fetchWithTimeout.js`
|
||||
- `GisStationsStaticDistrict`, `GisSystemStatic`
|
||||
|
||||
---
|
||||
|
||||
📄 Pfad: `/docs/frontend/services/api/fetchGisStatusStations.md`
|
||||
Reference in New Issue
Block a user