Vonage Reports API unterstützt jetzt auch Video API

Einführung

Vonage Reports API unterstützt jetzt die Video API-aber nur für Vonage API Dashboard (Unified) Benutzer. Wenn Sie ein OpenTok Dashboard Benutzer sind, ist diese Funktion nicht verfügbar.
Bis jetzt haben sich Entwickler, die mit der Video API arbeiten, hauptsächlich auf die Einblicke-API für detaillierte Sitzungsanalysen. Mit diesem Update können Sie auch über die Reports API auf Videodaten zugreifen, so dass Sie an einem einzigen Ort Nutzungs- und Berichtsinformationen über andere Vonage-APIs abrufen können, z. B. SMS, Nachrichten, Voiceund Verify.

Was ist die Reports API?

Die Reports API ist eine zentrale Möglichkeit, Nutzungs- und Berichtsdaten für alle Vonage-Produkte abzurufen. Sie ist jetzt auch für Video verfügbar und bietet Entwicklern und Unternehmen eine einheitliche Möglichkeit, Aktivitäts-, Abrechnungs- und Compliance-Daten zu verfolgen.

Warum die Reports API verwenden?

Sie vereinfacht die Berichterstattung, indem sie Nutzungs- und Abrechnungsdaten aus mehreren Vonage-APIs in ein einheitliches Format bringt. Weitere Informationen über die Reports API finden Sie im Einführungsartikel hier, oder lesen Sie ein Tutorial über eine Implementierung mit Laravel als Beispiel.

Reports API vs. Insights API

Bevor wir uns mit der Verwendung der Reports API für Videodaten befassen, möchten wir sie kurz mit den Insights und Advanced Insights APIs vergleichen. In der folgenden Tabelle werden die wichtigsten Unterschiede hervorgehoben, damit Sie sehen können, welches Produkt für Ihren Anwendungsfall am besten geeignet ist.

All features compared

So verwenden Sie die Reports API für Video API-Daten

Reports API für Video ist derzeit nur über die REST API verfügbar. Sie ist nicht über das Vonage Dashboard zugänglich, sodass Sie Ihre Anfragen über einen REST-Client stellen müssen.

Voraussetzungen

• Unified Video Account

• Ihr API-Schlüssel und Geheimnis

• Ein REST-Client (z. B. cURL, Postman)

Schritt 1. Berichtstyp auswählen

• Synchrone Berichte: Schnelle Ergebnisse für kleinere Datenmengen.

• Asynchrone Berichte: Besser für größere Datenmengen oder längere Zeiträume. Läuft im Hintergrund und gibt Ihnen einen Download-Link.
  Für weitere Details siehe Unterschiede zwischen synchronem und asynchronem Betrieb.

Schritt 2. Anfordern und Abrufen eines Berichts

2.1 Beispiel für einen synchronen Bericht

Senden Sie Ihre Anfrage

curl -X GET "https://api.nexmo.com/v2/reports/records?product=VIDEO-API&account_id=$VONAGE_API_KEY&date_start=2025-09-27T00:00:00Z&date_end=2025-09-30T23:59:59Z" \
-u "$VONAGE_API_KEY:$VONAGE_API_SECRET"

Beispiel einer Antwort (aus Gründen der Übersichtlichkeit gekürzt)

"records": [
        {
            "account_id": "xxxxx",
            "feature_name": "Subscriber minutes",
            "session_id": "xxxxx",
            "meeting_id": "",
            "subscriber_id": "xxxxx",
            "archive_id": "",
            "broadcast_id": "",
            "hls_id": "",
            "composer_id": "",
            "application_id": "xxxxx",
            "duration": "120.0",
            "date_start": "2025-09-29T11:29:12+00:00",
            "date_end": "2025-09-29T11:30:22+00:00",
            "total_price": "0",
            "currency": "EUR",
            "id": "xxxxx"
        },

Siehe die API-Referenz für synchrone Berichte finden Sie eine vollständige Aufschlüsselung der verfügbaren Felder und ihrer Definitionen.

2.2 Beispiel für einen asynchronen Bericht

Senden Sie Ihre Anfrage

curl -X POST "https://api.nexmo.com/v2/reports" \
  -u "$VONAGE_API_KEY:$VONAGE_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "product": "VIDEO-API",
    "account_id": "$VONAGE_API_KEY",
    "date_start": "2025-09-01T00:00:00Z",
    "date_end": "2025-09-30T23:59:59Z",
    "callback_url": "https://webhook.site/b7dd039b-afc7-464b-8fbd-1ef84820eaed"
  }'

Beispielergebnis (CSV) (aus Gründen der Übersichtlichkeit gekürzt)

Account_id,feature_name,session_id,application_id,duration,date_start,date_end,total_price,currency
xxxxx,Experience composer,xxxxx,xxxxx,7,2025-09-29T11:30:05+00:00,2025-09-29T11:30:12+00:00,0,EUR
xxxxx,Subscriber minutes,xxxxx,xxxxx,120,2025-09-29T11:29:12+00:00,2025-09-29T11:30:22+00:00,0,EUR
xxxxx,Interconnect,xxxxx,xxxxx,120,2025-09-29T11:29:12+00:00,2025-09-29T11:30:22+00:00,0.0094596,EUR

Der Einfachheit halber habe ich hier nur die Grundlagen dargestellt. Eine vollständige Schritt-für-Schritt-Anleitung zur Erstellung asynchroner Berichte finden Sie in dem Artikel.

Sind Sie bereit, die Reports API für Video zu erkunden?

Sie können jetzt über die Reports API auf Ihre Nutzungs- und Abrechnungsdaten der Video API zugreifen - alles an einem Ort. Wenn Sie technische Fragen zur Reports API für Video haben, wenden Sie sich an unser Video API Support Team über das Support-Portal. Denken Sie über einen Wechsel von OpenTok zu Unified nach? Dies ist ein guter Zeitpunkt, um die erweiterten Berichtsfunktionen zu erkunden. Wenden Sie sich an Ihren Account Manager, um Einzelheiten zur Migration zu erfahren.