Skip to content

Umsatzdaten nach Zeit exportieren

get

/purchases/revenue_series

Verwenden Sie diesen Endpunkt, um die Gesamtausgaben in Ihrer App über einen bestimmten Zeitraum abzurufen.

Voraussetzungen

Um diesen Endpunkt zu verwenden, benötigen Sie einen API-Schlüssel mit der Berechtigung purchases.revenue_series.

Rate-Limit

Wir wenden auf diesen Endpunkt ein gemeinsames Rate-Limit von 1.000 Anfragen pro Stunde an. Dieses Rate-Limit wird mit den Endpunkten /custom_attributes, /events und /events/list geteilt, wie in API-Rate-Limits dokumentiert.

Anfrageparameter

Parameter Erforderlich Datentyp Beschreibung
ending_at Optional Datetime (ISO-8601 String) Datum, an dem der Datenexport enden soll. Standardmäßig wird der Zeitpunkt der Anfrage verwendet.
length Erforderlich Integer Maximale Anzahl der Tage vor ending_at, die in der zurückgegebenen Serie enthalten sein sollen. Muss zwischen 1 und 100 (einschließlich) liegen.
unit Optional String Zeiteinheit zwischen Datenpunkten. Kann Tag oder Stunde sein, Standardeinstellung ist Tag.
app_id Optional String API-Bezeichner der App, abgerufen von der Seite API-Schlüssel. Wenn nicht angegeben, werden die Ergebnisse für alle Apps in einem Workspace zurückgegeben.
product Optional String Name des Produkts, nach dem die Antwort gefiltert werden soll. Wenn nicht angegeben, werden die Ergebnisse für alle Apps zurückgegeben.

Beispielanfrage

1
2
curl --location --request GET 'https://rest.iad-01.braze.com/purchases/revenue_series?length=100' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

Antwort

1
2
3
4
5
6
7
8
9
10
{
  "message": (required, string) the status of the export, returns 'success' when completed without errors,
  "data" : [
    {
      "time" : (string) the date as ISO 8601 date,
      "revenue" : (int) amount of revenue for the time period
      },
    ...
  ]
}
New Stuff!