Account Management

Account-Administratoren können die OpenTok-REST-API nutzen, um einzelne Projekte in ihrem OpenTok-Account anzulegen und zu verwalten.

Beispielsweise möchten Sie vielleicht verschiedene Projekte anlegen, die verschiedenen Kunden entsprechen. Durch separate Projekte kann OpenTok die Nutzung für jeden Kunden individuell nachverfolgen.

Jedes Projekt verfügt über ein eigenes, einzigartiges OpenTok Projekt API-Schlüssel und Projekt API Geheimnis.

Nehmen wir beispielsweise an, ein Kunde – Acme – nutzt Ihren Dienst. Sie können die OpenTok-REST-API verwenden, um für diesen Kunden einen OpenTok-Projekt-API-Schlüssel und ein Projekt-API- Geheimnis zu erstellen.

Mit der OpenTok-REST-API können Sie Folgendes tun:

• Erstellen Sie ein neues Projekt für Ihren OpenTok-Account
• Einen Projekt-API-Schlüssel sperren oder wieder aktivieren
• Ein Projekt löschen
• Informieren Sie sich über ein bestimmtes Projekt oder über alle Projekte für einen Account
• Ein neues API-Geheimnis für ein Projekt generieren
• Geben Sie ein Amazon S3- oder Microsoft Azure-Upload-Ziel an für die Archivdateien eines Projekts
• Ein Upload-Ziel löschen für die Archivdateien eines Projekts

Verwenden Sie für die folgenden REST-API-Aufrufe die auf Account-Ebene API-Schlüssel und -Geheimnis. Um den API-Schlüssel und das API-Geheimnis auf Account-Ebene abzurufen, melden Sie sich bei Ihrem Video API-Konto, klicken Account-Einstellungen im Menü auf der linken Seite und dann unter OpenTok REST API, klicken Account-Schlüssel anzeigen. Der API-Schlüssel und das API-Passwort auf Account-Ebene stehen ausschließlich registrierten Administratoren Ihres OpenTok-Accounts zur Verfügung. Verwenden Sie den API-Schlüssel und das API-Passwort auf Account-Ebene, wenn Sie die Authentifizierungstoken die Sie im REST-API-Aufruf verwenden:

• Ein neues Projekt für Ihren OpenTok-Account erstellen
• Einen Projekt-API-Schlüssel sperren oder wieder aktivieren
• Ein Projekt löschen
• Informationen zu einem bestimmten Projekt oder zu allen Projekten abrufen für einen Account
• Ein neues API-Geheimnis für ein Projekt generieren

Der API-Schlüssel und das API-Passwort auf Account-Ebene stehen ausschließlich registrierten Administratoren Ihres OpenTok-Accounts zur Verfügung.

Für andere REST-API-Aufrufe verwenden Sie den API-Schlüssel und den API-Secret für das jeweilige Projekt in Ihrem Account. Diese finden Sie auf der Projektseite Ihres Accounts Video API-Konto.

Objekt „Projektdetails“

Viele Antworten auf REST-API-Aufrufe enthalten ein Objekt mit Projektdetails. Dieser Teil der JSON-Antwort enthält Angaben zum Projekt. Er hat das folgende Format:

{
  "id":  "12312",
  "secret":  "567890",
  "status": "ACTIVE",
  "name": "Joe Montana",
  "environment": "standard",
  "createdAt": 1414642898000 // A UNIX timestamp (in milliseconds)
}

Das Objekt „Projektdetails“ verfügt über die folgenden Eigenschaften:

• id — Der API-Schlüssel des OpenTok-Projekts

• secret — Der API-Schlüssel des OpenTok-Projekts

• status — Ob das Projekt aktiv ist ("ACTIVE") oder ausgesetzt ("SUSPENDED"). Siehe Einen Projekt-API-Schlüssel sperren oder freischalten.

• name — Der Name, sofern Sie bei der Erstellung des Projekts einen angegeben haben; andernfalls eine leere Zeichenfolge

• environment - Diese ist eingestellt auf "standard" oder "enterprise", und damit ist die Umgebung gemeint, in der ein Projekt ausgeführt wird. Partner mit einem Enterprise-Paket haben Zugriff auf die Enterprise-Umgebung. Weitere Informationen finden Sie in unserem Support-Pakete Seite. Falls Sie weitere Fragen haben, wenden Sie sich bitte an kontaktieren Sie uns.

• createdAt — Der Zeitpunkt, zu dem das Projekt erstellt wurde (ein UNIX-Zeitstempel in Millisekunden)

Bitte ignorieren Sie alle anderen Eigenschaften im Objekt „Projektdetails“.