Parameter in der URL

Übersicht

Mit Query-Parametern richten Sie einen Meetingraum direkt über dessen URL ein. Sie steuern damit einen eingebetteten Raum, ohne eine Zeile Code zu schreiben. Am meisten nützen sie Ihnen, wenn Sie den Raum als iFrame in Ihre eigene Anwendung einbinden.

Sie hängen die Parameter an eine Meeting-URL an:

https://<DOMAIN-NAME>/meeting/<MEETING-ID>?participantName=Test%20User&meetingPassword=1234

URL-codieren Sie jeden Wert. Sonst zerstören Sie den Rest der URL: ein Name mit einem Leerzeichen, eine E-Mail-Adresse oder jeder Wert, in dem & oder = vorkommt.

Für boolesche Parameter schreiben Sie die Strings true oder false.

Verwendung mit einem KI-Assistenten

Wenn Sie mit einem KI-Coding-Assistenten arbeiten, können Sie den folgenden Text in Ihren Assistenten kopieren und mit einem Satz ergänzen, der beschreibt, was Sie programmieren möchten.

Der Prompt verweist auf unsere Entwicklerdokumentation, die wir für Coding-Assistenten in einer separaten, token-optimierten KI-Version ausliefern.

Lies zuerst diese Seite, bevor Du Code schreibst:
https://www.veeting.com/de/developer-documentation/query-parameters

Sie dokumentiert die URL-Query-Parameter eines Veeting Rooms
Meetingraums. Halte Dich an diese fünf Regeln:

1. URL-codiere jeden Wert. Namen und E-Mail-Adressen enthalten
   meist Zeichen, die das verlangen.
2. Boolesche Werte sind die Strings «true» und «false», nicht 1
   oder yes.
3. Parameternamen sind Identifier. Übersetze sie nie, in welcher
   Sprache die umgebende Seite auch verfasst ist.
4. Die Plattform entfernt Token und personenbezogene Daten aus der
   URL. Lies diese Werte darum später nicht aus window.location
   zurück, sondern halte sie in der Anwendung.
5. Verwende nur Parameter, die auf dieser Seite stehen. Erfinde
   keine und nimm keine, die Du in unserem JavaScript-Bundle
   gefunden hast.

Was ich bauen möchte:

Zwei Dinge vorab

Die Plattform entfernt einige Parameter aus der URL. Alles, was einen Token oder personenbezogene Daten mitführt, verschwindet wieder: entweder sofort oder bevor der Browser navigiert. Das tun wir mit Absicht, damit solche Werte nicht im Browserverlauf, in einem Lesezeichen oder in einem Referer-Header überdauern. Die beiden Listen stehen am Ende dieser Seite. Lesen Sie sie, wenn Sie einen Parameter später wieder aus der Adresszeile holen möchten.

Diese Seite führt nicht jeden Parameter auf, den die Plattform akzeptiert. Die übrigen arbeiten intern, bedienen unsere Support-Tools oder führen Access Tokens mit, die wir nicht öffentlich beschreiben. Brauchen Sie einen Parameter, der hier fehlt, dann fragen Sie uns. Verlassen Sie sich nicht auf einen, den Sie im Bundle gefunden haben: Für einen undokumentierten Parameter sichern wir Ihnen keine Kompatibilität zu.

Angaben zum Teilnehmer

Mit diesen Parametern füllen Sie den Screen «Sitzung beitreten» vor. Ihre Teilnehmer müssen dann nichts mehr eintippen.

Zugriff und Authentifizierung

Hinweis: Diese Werte sind Zugangsdaten. Erzeugen Sie sie pro Teilnehmer und halten Sie sie aus geteilten Links heraus. Genau deshalb entfernt die Plattform die meisten davon wieder aus der URL, siehe «Parameter, die die Plattform entfernt» weiter unten.

Der Screen «Sitzung beitreten»

Darstellung und Medien

Geräte

Im Meeting

Einbettung, Test und Support

Parameter, die die Plattform entfernt

Die Plattform entfernt zwei Gruppen von Parametern aus der URL. Beides ist kein Fehler, überrascht Sie aber, sobald Sie einen Wert später wieder aus window.location lesen möchten.

Sofort entfernt, immer. Diese überdauern nie in der Adresszeile:

meetingAccessToken
meetingAccessRequestToken
meetingChallengeCode

Entfernt, bevor der Browser navigiert. Der Raum liest diese Werte zuerst und löscht sie dann. So gelangen sie nicht über den Verlauf, ein Lesezeichen oder einen Referer-Header an Dritte:

skipJoinMeetingScreen   jwtToken          moderatorToken
invisibleToken          interpreterToken  authenticationSkipToken
participantName         participantUuid   participantEmail

Brauchen Sie einen Wert nach dem Beitritt, dann halten Sie ihn in Ihrer eigenen Anwendung. Lesen Sie ihn nicht aus der URL zurück.

Häufige Fehler

• Sie URL-codieren einen Wert nicht. Meist stolpern Sie über ein Leerzeichen in participantName.
• Sie setzen skipJoinMeetingScreen=true ohne participantName, und der Teilnehmer bleibt namenlos.
• Sie blenden den Einwilligungsabschnitt aus und halten die Einwilligung damit für erledigt.
• Sie erwarten moderatorToken oder participantName noch in der URL, nachdem der Meetingraum geladen hat.
• Sie senden 1 oder yes als booleschen Wert. Erkannt werden nur true und false.
• Sie übersetzen einen Parameternamen. Es sind Identifier und immer englisch.
• Sie verwenden einen undokumentierten Parameter aus dem Bundle, für den wir Ihnen keine Kompatibilität zusichern.