Projekte und Einheiten per API anlegen

Projekt erstellen

Senden Sie POST /projects mit einem Namen und den gewünschten Adressfeldern. Speichern Sie die zurückgegebene project.id. Das frühere Projektfeld visibility wird angenommen, aber ignoriert; Sichtbarkeit gehört zur Einheit.

{
  "name": "Beispielprojekt",
  "street": "Musterstraße",
  "houseNumber": "10",
  "postalCode": "10115",
  "city": "Berlin"
}

Einheiten hinzufügen

Eine einzelne Einheit erstellen Sie mit POST /projects/{id}/properties. Für mehrere Einheiten verwenden Sie POST /projects/{id}/imports mit folgendem Body:

{
  "units": [
    {
      "unitIdentifier": "WE-01",
      "unitNumber": "1",
      "etage": 1,
      "wohnflaecheQm": "64.50",
      "kaufpreis": "320000.00",
      "visibility": "offline",
      "status": "frei"
    }
  ]
}

Ein Sammelimport akzeptiert 1 bis 200 Einheiten. etage ist eine ganze Zahl; etageLabel kann die angebotene Etagenbezeichnung aufnehmen. Verwenden Sie Dezimalpunkte für numerische Strings.

Ergebnis behandeln

Der Import arbeitet in v1 synchron, antwortet aber mit 202 und status: "completed". Speichern Sie importRunId; über GET /imports/{id} lesen Sie den Status. Tarif- und Online-Kontingente gelten auch für API-Importe. Die API bietet für diese POST-Aufrufe keinen dokumentierten Idempotency-Key und kein Upsert. Ein erneuter Aufruf kann weitere Datensätze erzeugen. Prüfen Sie nach einem Verbindungsabbruch zuerst den Bestand.

Grundlagen

Ordner

Projekte

Einheiten

Importe

Projekte und Einheiten per API anlegen

Projekt erstellen

Einheiten hinzufügen

Ergebnis behandeln

​Projekt erstellen

​Einheiten hinzufügen

​Ergebnis behandeln

Projekt erstellen

Einheiten hinzufügen

Ergebnis behandeln