Integrationen auflisten

Verwenden Sie diesen Endpunkt, um eine Liste der vorhandenen Integrationen zurückzugeben.

Hinweis

Um diesen Endpunkt zu verwenden, müssen Sie einen API-Schlüssel mit der Berechtigung cdi.integration_list erstellen.

Rate-Limit

Dieser Endpunkt hat ein Rate-Limit von 50 Anfragen pro Minute.

Abfrageparameter

Jeder Aufruf dieses Endpunkts gibt 10 Einträge zurück. Bei einer Liste mit mehr als 10 Integrationen verwenden Sie den Link-Header, um die Daten auf der nächsten Seite abzurufen, wie in der Beispielantwort gezeigt.

Beispielanfrage

Ohne Cursor

1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/cdi/integrations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

Mit Cursor

1
2
3
curl --location --request GET 'https://rest.iad-03.braze.com/cdi/integrations?cursor=c2tpcDow' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

Antwort

Beispiel für eine erfolgreiche Antwort

Der Statuscode 200 könnte den folgenden Antwortkörper zurückgeben.

Hinweis

Der Link-Header ist nicht vorhanden, wenn es insgesamt weniger als oder gleich 10 Integrationen gibt. Bei Aufrufen ohne Cursor wird prev nicht angezeigt. Wenn Sie sich die letzte Seite der Einträge ansehen, wird next nicht angezeigt.

1
Link: </cdi/integrations?cursor=c2tpcDow>; rel="prev",</cdi/integrations?cursor=c2tpcDoxMDA=>; rel="next"

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
  "results": [
    {
      "integration_id": (string) integration ID,
      "app_group_id": (string) app group ID,
      "integration_name": (string) integration name,
      "integration_type": (string) integration type,
      "integration_status": (string) integration status,
      "contact_emails": (string) contact email(s),
      "last_updated_at": (string) last timestamp that was synced in ISO 8601,
      "warehouse_type": (string) data warehouse type,
      "last_job_start_time": (string) timestamp of the last sync run in ISO 8601,
      "last_job_status": (string) status of the last sync run,
      "next_scheduled_run": (string) timestamp of the next scheduled sync in ISO 8601
    }
  ],
  "message": "success"
}

Fehlerbehebung

In der folgenden Tabelle finden Sie eine Liste möglicher zurückgegebener Fehler und die entsprechenden Schritte zur Fehlerbehebung.

Weitere Statuscodes und zugehörige Fehlermeldungen finden Sie unter Schwerwiegende Fehler und Antworten.