Venues (Adressen) über die API verwalten

Überblick

Venues (Veranstaltungsorte) sind erforderlich für die Erstellung von Events. Jedes Event benötigt eine address_id, die auf einen gültigen Veranstaltungsort verweist.

Wichtig: Derzeit gibt es keine direkten API-Endpunkte zum Erstellen von Venues. Adressen müssen über die Web-Oberfläche erstellt werden oder können über die Datenbank verwaltet werden.

Venue-Datenstruktur

Ein Venue (Address) enthält folgende Informationen:

Feld	Typ	Beschreibung
id	Integer	Eindeutige ID des Venues
street	String	Straße und Hausnummer
city	String	Stadt
state	String	Bundesland/Staat
zip	String	Postleitzahl
country	String	Land
latitude	Decimal	Breitengrad (für Karte)
longitude	Decimal	Längengrad (für Karte)
metadata	JSON	Zusätzliche Informationen

Venue in Event-Response

Wenn Sie ein Event über die API abrufen, ist das zugehörige Venue enthalten:

GET /api/events/123
Authorization: Bearer YOUR_TOKEN_HERE

Beispiel-Antwort

{
  "data": {
    "id": 123,
    "title": "Immobilien-Fachmesse 2024",
    "address": {
      "id": 15,
      "street": "Messestraße 1",
      "city": "Berlin",
      "state": "Berlin",
      "zip": "10115",
      "country": "Deutschland",
      "latitude": "52.520008",
      "longitude": "13.404954",
      "metadata": {
        "venue_name": "Messe Berlin",
        "hall": "Halle 2",
        "capacity": 500
      },
      "created_at": "2024-01-15T10:00:00.000000Z",
      "updated_at": "2024-01-15T10:00:00.000000Z"
    },
    ...
  }
}

Venue über Web-Oberfläche erstellen

Voraussetzungen

1. Sie sind angemeldet
2. Sie haben Administrator-Rechte für ein Unternehmen
3. Ihr Unternehmen ist verifiziert

Schritte

1. Navigieren Sie zu Ihrem Unternehmensprofil
2. Wählen Sie "Standorte" oder "Adressen"
3. Klicken Sie auf "Neue Adresse hinzufügen"
4. Füllen Sie die Pflichtfelder aus:
   • Venue-Name (optional, wird in Metadata gespeichert)
   • Straße und Hausnummer
   • Postleitzahl
   • Stadt
   • Land
5. Optional: Laden Sie ein Foto der Location hoch
6. Klicken Sie auf "Speichern"

Die Koordinaten (Latitude/Longitude) werden automatisch aus der Adresse generiert.

Venue-ID für Event verwenden

Nachdem Sie ein Venue erstellt haben, können Sie die ID in Ihren Event-API-Requests verwenden:

POST /api/events
Authorization: Bearer YOUR_TOKEN_HERE

{
  "title": "Meine Veranstaltung",
  "description": "Beschreibung der Veranstaltung mit mindestens 100 Zeichen...",
  "start": "2024-07-01T10:00:00Z",
  "end": "2024-07-01T18:00:00Z",
  "company_id": 42,
  "address_id": 15  // ← Die ID des erstellten Venues
}

Venue-IDs abrufen

Option 1: Über das Filament-Panel

1. Melden Sie sich im Admin-Panel an
2. Navigieren Sie zu "Adressen" oder "Standorte"
3. Die ID wird in der Tabellenspalte angezeigt

Option 2: Über die Datenbank

Wenn Sie direkten Datenbankzugriff haben:

SELECT id, street, city, zip, country
FROM addresses
WHERE addressable_type = 'App\\Models\\Company'
  AND addressable_id = YOUR_COMPANY_ID;

Option 3: Über Event-Listing

Wenn Sie bereits Events erstellt haben:

GET /api/events
Authorization: Bearer YOUR_TOKEN_HERE

Die Response enthält die address-Objekte mit ihren IDs.

Häufige Fehler

1. Ungültige address_id

Fehler:

{
  "message": "The selected address does not exist.",
  "errors": {
    "address_id": ["The selected address does not exist."]
  }
}

Lösung: Stellen Sie sicher, dass die Adresse existiert und Sie Zugriff darauf haben.

2. Fehlende address_id

Fehler:

{
  "message": "The venue (address) is required.",
  "errors": {
    "address_id": ["The venue (address) is required."]
  }
}

Lösung: Jedes Event benötigt eine address_id. Erstellen Sie zuerst ein Venue über die Web-Oberfläche.

3. Adresse gehört zu anderem Unternehmen

Fehler:

{
  "message": "The selected address does not exist.",
  "errors": {
    "address_id": ["The selected address does not exist."]
  }
}

Lösung: Venues sind unternehmensspezifisch. Sie können nur Venues verwenden, die zu Ihrem Unternehmen gehören.

Best Practices

1. Wiederverwendbare Venues erstellen

Erstellen Sie Venues für häufig genutzte Veranstaltungsorte und verwenden Sie diese für mehrere Events:

// Event 1 - Messestand Berlin
{
  "title": "Frühjahrs-Fachmesse 2024",
  "address_id": 15,
  ...
}

// Event 2 - Selber Ort
{
  "title": "Herbst-Fachmesse 2024",
  "address_id": 15,  // ← Gleiche Location
  ...
}

2. Vollständige Adressen angeben

Geben Sie vollständige Adressen an, um:

• Korrekte Geocoding-Koordinaten zu erhalten
• Teilnehmern präzise Navigation zu ermöglichen
• In Suchmaschinen besser gefunden zu werden

3. Metadata nutzen

Nutzen Sie das metadata-Feld für zusätzliche Informationen:

{
  "venue_name": "Congress Center Hamburg",
  "hall": "Saal 3",
  "floor": "2. OG",
  "capacity": 300,
  "parking": "Tiefgarage vorhanden",
  "accessibility": "Rollstuhlgerecht",
  "contact_phone": "+49 40 123456"
}

4. Fotos hochladen

Laden Sie immer ein Foto der Location hoch:

• Hilft Teilnehmern, den Ort zu erkennen
• Verbessert die Präsentation Ihres Events
• Erhöht die Konversionsrate

Geplante Erweiterungen

In zukünftigen Versionen der API sind folgende Endpunkte geplant:

• GET /api/venues - Alle Venues des Unternehmens auflisten
• POST /api/venues - Neues Venue erstellen
• PUT /api/venues/{id} - Venue aktualisieren
• DELETE /api/venues/{id} - Venue löschen

Weitere Informationen

• Events über die API erstellen
• API-Token erstellen
• Unternehmen verwalten

Support

Wenn Sie Unterstützung beim Erstellen von Venues benötigen oder API-Endpunkte für Venues wünschen, kontaktieren Sie bitte den Support oder erstellen Sie ein Feature-Request im Issue-Tracker.