Skip to content

Anzahl der Käufe exportieren

get

/purchases/quantity_series

Verwenden Sie diesen Endpunkt, um die Gesamtzahl der Käufe in Ihrer App über einen bestimmten Zeitraum zurückzugeben.

Voraussetzungen

Um diesen Endpunkt zu verwenden, benötigen Sie einen API-Schlüssel mit der Berechtigung purchases.quantity_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 App-API-Bezeichner, der auf der Seite API-Schlüssel abgerufen wird. 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/quantity_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,
      "purchase_quantity" : (int) the number of items purchased in the time period
      },
    ...
  ]
}
New Stuff!