Überblick

Diese API führt Interessenten mit ihren Suchprofilen, nimmt Anfragen entgegen und bewertet, wie gut beides zu einem Objekt passt.

Bewertung nachvollziehbar halten

Jede Bewertung liefert nicht nur eine Punktzahl, sondern die einzelnen Kriterien mit ihrem Gewicht. Das ist Absicht: Wenn ein Interessent fragt, warum er keinen Besichtigungsplatz bekommen hat, können Sie es beantworten – und Sie erkennen selbst, wenn ein Kriterium wie finanzierungsnachweis systematisch die Liste verzerrt.

Datenschutz ist eingebaut

Jeder Interessent trägt ein aufbewahrung_bis. Es wird beim Anlegen aus dem Sachverhalt abgeleitet und mit jeder Aktivität neu berechnet. Nach Ablauf werden Name, Anschrift und Kontaktdaten nächtlich entfernt; die statistischen Merkmale bleiben für Auswertungen erhalten.

Eine einwilligung ist Pflicht. Ohne sie lehnt die API das Anlegen mit 400 ab – bewusst, denn eine nachträglich beschaffte Einwilligung ist in der Praxis kaum je zu belegen.

Ein Löschverlangen setzen Sie über POST /interessenten/{id}/loeschung sofort um; es hat Vorrang vor jeder Frist.

Benötigte Scopes

interessenten:lesen zum Abfragen, interessenten:schreiben zum Pflegen und Bewerten.