Navigation

API v2

Mängelmelder API v2 – Defects

Die Mängelmelder API v2 ermöglicht den strukturierten und automatisierten Zugriff auf Mängelmeldungen (Defects) aus dem Mängelmelder-System. Sie richtet sich an Entwickler und Systemintegratoren, die Mängelmeldungen in eigene Fachanwendungen, GIS-Systeme, Ticketsysteme oder Auswertungen integrieren möchten.

Authentifizierung

Der Zugriff auf die API erfolgt über eine tokenbasierte Authentifizierung mittels Bearer Token (API-Key). Der API-Key muss bei jedem Request im HTTP-Header übermittelt werden.

Authorization: Bearer <API-Key>
Accept: application/json

Endpoint

Der Defects-Endpoint wird per HTTP GET aufgerufen und liefert die Ergebnisse im JSON-Format zurück.

GET /api/v2/defects

Query-Parameter

Die Abfrage kann über optionale Query-Parameter gefiltert werden. Nicht gesetzte oder leere Parameter werden ignoriert.

customer – Kundenverzeichnis / Mandant
showAll – 1 für vollständige Ausgabe, sonst leer
from – Startdatum (YYYY-MM-DD)
to – Enddatum (YYYY-MM-DD)
hasGeoData – 1 für Meldungen mit Geodaten, sonst leer

Response

Die API antwortet mit einem JSON-Payload. Zusätzlich zum Response-Body sollte immer der HTTP-Statuscode ausgewertet werden (z. B. 200 OK bei erfolgreicher Anfrage).

Technische Hinweise

Die Nutzung erfolgt ausschließlich über HTTPS.
SSL-Zertifikatsprüfung sollte produktiv aktiviert sein.
Zur Performance-Optimierung wird empfohlen, Datumsfilter zu verwenden.
Fehlerfälle sollten anhand von HTTP-Statuscodes und Response-Inhalten behandelt werden.

Beispiele

PHP

Curl

PHP

<?php

$params = http_build_query([
	'customer' => '', // Kundenverzeichnis
	'showAll' => 1, // 1 oder leer
	'from' => '', // YYYY-MM-DD oder leer
	'to' => '', // YYYY-MM-DD oder leer
	'hasGeoData' => '', // 1 oder leer
]);

$url = "https://maengelmelder.eu/de-wGlobal/wGlobal/scripts/php/maengelmelder/api/v2/defects?$params";
$token = ""; // API-Key

$ch = curl_init($url);

// Header vorbereiten
$headers = [
	"Authorization: Bearer $token",
	"Accept: application/json",
];

// cURL-Optionen setzen
curl_setopt_array($ch, [
	CURLOPT_RETURNTRANSFER => true, 
	CURLOPT_HTTPHEADER => $headers, 
	CURLOPT_TIMEOUT => 10,         
	CURLOPT_SSL_VERIFYPEER => true,
]);

// Request ausführen
$response = curl_exec($ch);
$httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if (curl_errno($ch)) {
	echo "cURL Fehler: " . curl_error($ch);
	exit;
}

curl_close($ch);

?>