Skip to content

Supprimer un produit du catalogue

delete

/catalogs/{catalog_name}/items/{item_id}

Utilisez cet endpoint pour supprimer un produit de votre catalogue.

Conditions préalables

Pour utiliser cet endpoint, vous aurez besoin d’une clé API avec l’autorisation catalogs.delete_item.

Limite de débit

Cet endpoint a une limite de débit partagée de 50 requêtes par minute entre tous les endpoints d’éléments de catalogue synchrones, comme documenté dans Limites de débit de l’API.

Paramètres de chemin

Paramètre Requis Type de données Description
catalog_name Requis Chaîne de caractères Nom du catalogue.
item_id Requis Chaîne de caractères L’ID du produit du catalogue.

Paramètres de requête

Cet endpoint n’a pas de corps de requête.

Exemple de requête

1
2
3
curl --location --request DELETE 'https://rest.iad-03.braze.com/catalogs/restaurants/items/restaurant1' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

Réponse

Trois codes de statut peuvent être renvoyés pour cet endpoint : 202, 400 et 404.

Exemple de réponse réussie

Le code de statut 202 pourrait renvoyer le corps de réponse suivant.

1
2
3
{
  "message": "success"
}

Exemple de réponse en erreur

Le code de statut 400 pourrait renvoyer le corps de réponse suivant. Consultez la section Résolution des problèmes pour plus d’informations concernant les erreurs que vous pourriez rencontrer.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
  "errors": [
    {
      "id": "item-not-found",
      "message": "Could not find item",
      "parameters": [
        "item_id"
      ],
      "parameter_values": [
        "restaurant34"
      ]
    }
  ],
  "message": "Invalid Request"
}

Résolution des problèmes

Le tableau suivant répertorie les erreurs renvoyées possibles et les étapes de résolution des problèmes associées.

Erreur Résolution des problèmes
arbitrary-error Une erreur arbitraire est survenue. Veuillez réessayer ou contacter l’assistance.
catalog-not-found Vérifiez que le nom du catalogue est valide.
item-not-found Vérifiez que le produit à supprimer existe dans votre catalogue.
New Stuff!