Katalogfeld löschen
/catalogs/{catalog_name}/fields/{field_name}
Verwenden Sie diesen Endpunkt, um ein Katalogfeld zu löschen.
Voraussetzungen
Um diesen Endpunkt zu verwenden, benötigen Sie einen API-Schlüssel mit der Berechtigung catalogs.delete_fields.
Rate-Limit
Für diesen Endpunkt gilt ein gemeinsames Rate-Limit von 50 Anfragen pro Minute für alle asynchronen Katalogfelder- und Auswahl-Endpunkte, wie in API-Rate-Limits dokumentiert.
Pfadparameter
| Parameter | Erforderlich | Datentyp | Beschreibung |
|---|---|---|---|
catalog_name |
Erforderlich | String | Name des Katalogs. |
field_name |
Erforderlich | String | Name des Katalogfeldes. |
Beispielanfrage
1
2
3
curl --location --request DELETE 'https://rest.iad-03.braze.com/catalogs/restaurants/fields/ratings' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
Antwort
Für diesen Endpunkt gibt es zwei Statuscode-Antworten: 202 und 404.
Beispiel für eine erfolgreiche Antwort
Der Statuscode 202 könnte den folgenden Antworttext zurückgeben:
1
2
3
{
"message": "success"
}
Beispiel für eine Fehlerantwort
Der Statuscode 404 könnte den folgenden Antworttext zurückgeben. Unter Fehlerbehebung finden Sie weitere Informationen zu Fehlern, die bei Ihnen auftreten können.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"errors": [
{
"id": "catalog-not-found",
"message": "Could not find catalog",
"parameters": [
"catalog_name"
],
"parameter_values": [
"restaurants"
]
}
],
"message": "Invalid Request"
}
Fehlerbehebung
In der folgenden Tabelle finden Sie eine Liste möglicher zurückgegebener Fehler und die entsprechenden Schritte zur Fehlerbehebung.
| Fehler | Fehlerbehebung |
|---|---|
catalog-not-found |
Prüfen Sie, ob der Katalogname gültig ist. |
field-referenced-by-selection |
Prüfen Sie, ob das Katalogfeld derzeit von einer Auswahl verwendet wird. |
field-is-inventory |
Prüfen Sie, ob das Katalogfeld als Inventarfeld verwendet wird. |
invalid-field-name |
Prüfen Sie, ob der Name des Katalogfeldes gültig ist. |