FoyerDevelopers

Generated · Live registry

vermietungBelegung tools

5 tools in this domain, generated from the running registry.

All tool domains

vermietungBelegung.haAbrufen

writes

Pulls the active HousingAnywhere source of an apartment fresh and takes over its occupancy; if the last pull was less than 60 seconds ago, it does not pull again but reports the stored state. Returns status (aktuell, zuletzt_gueltig, unbekannt, keine_quelle), letzterErfolg and fehler. An apartment of another tenant results in NOT_FOUND. Owner of a rental tenant only. Changes data. Mutation — changes data.

Input parameters

FieldTypeRequiredNotes
wohnungIdstringyes

Output fields

FieldTypeRequiredNotes
statusenumyesOne of: aktuell, zuletzt_gueltig, unbekannt, keine_quelle
letzterErfolgstring · nullableyes
fehlerstring · nullableyes

vermietungBelegung.haQuelleSetzen

writes

Sets the HousingAnywhere calendar address of an apartment (url, exactly the form https://housinganywhere.com/api/v2/listing/<digits>/calendar/<secret>/<language>; anything else results in BAD_REQUEST) and pulls it immediately. The previous source is switched off (at most one stays active) and its upcoming imported stays are cancelled; url null only switches off. An address still active on another apartment results in CONFLICT. If the pull fails, the source stays saved and haAbruf names the error. Returns haAbruf. An apartment of another tenant results in NOT_FOUND. Owner of a rental tenant only. Changes data. Mutation — changes data.

Input parameters

FieldTypeRequiredNotes
wohnungIdstringyes
urlstring · nullableyes

Output fields

FieldTypeRequiredNotes
haAbrufobjectyes
haAbruf.statusenumyesOne of: aktuell, zuletzt_gueltig, unbekannt, keine_quelle
haAbruf.letzterErfolgstring · nullableyes
haAbruf.fehlerstring · nullableyes

vermietungBelegung.sperreEntfernen

writes

Lifts the own blocks of an apartment from von to bis (both inclusive) and returns the number of nights released. Nights of tenancies and blocks with a different reason stay untouched. An apartment of another tenant results in NOT_FOUND. Owner of a rental tenant only. Deletes data. Mutation — changes data.

Input parameters

FieldTypeRequiredNotes
wohnungIdstringyes
vonstringyes
bisstringyes

Output fields

FieldTypeRequiredNotes
naechteintegeryes

vermietungBelegung.sperreSetzen

writes

Blocks an apartment from von to bis (both inclusive, YYYY-MM-DD) with a reason (at most 120 characters, one line) and returns the number of blocked nights. If even one night is already occupied (tenancy, HousingAnywhere import or another block), the result is CONFLICT and nothing is blocked; von after bis results in BAD_REQUEST, as does a block longer than three years; an apartment of another tenant results in NOT_FOUND. Owner of a rental tenant only. Changes data. Mutation — changes data.

Input parameters

FieldTypeRequiredNotes
wohnungIdstringyes
vonstringyes
bisstringyes
grundstringyes

Output fields

FieldTypeRequiredNotes
naechteintegeryes

vermietungBelegung.uebersicht

read-only

The occupancy of all apartments from today (Berlin) for 12 or 24 months (monate): per apartment wohnungId, kuerzel, titel and the occupancy as ranges from von to bisExklusiv (the day the apartment is free again) with the source: mietverhaeltnis, import (HousingAnywhere calendar, label = platform), sperre (own block, label = reason) or sonstige. Owner of a rental tenant only. Read-only query.

Input parameters

FieldTypeRequiredNotes
monateliteralyes

Output fields

Returns array of object. Fields of each element:

FieldTypeRequiredNotes
wohnungIdstringyes
kuerzelstringyes
titelstringyes
belegungarray of objectyes
belegung.vonstringyes
belegung.bisExklusivstringyes
belegung.quelleenumyesOne of: mietverhaeltnis, import, sperre, sonstige
belegung.etikettstring · nullableyes