Tarification par volume : autres méthodes d'API

Récupérez ou supprimez un enregistrement de tarification par volume à partir de son ID avec l'API publique.

Ce document explique comment récupérer et supprimer des enregistrements de tarification par volume avec l’API publique.

Récupérer un enregistrement de tarification par volume

1. Point de terminaison

Pour récupérer un enregistrement de tarification par volume précis :

GET https://wholesale.samita.io/api/v1/volume-pricings/{id}

{id} correspond à l’ID de l’enregistrement de tarification par volume

L’ID est disponible dans l’interface de l’application
N’incluez pas le symbole « # » lorsque vous utilisez l’ID

Exemple :

GET https://wholesale.samita.io/api/v1/volume-pricings/1

2. En-têtes de la requête

Toutes les requêtes GET doivent inclure les en-têtes obligatoires suivants :

En-tête	Description	Obligatoire
`X-SAMITA-API-KEY`	Clé API fournie dans l’application Wholesale	Oui
`X-SAMITA-SHOP-URL`	Domaine de la boutique Shopify au format xxx.myshopify.com	Oui
`CONTENT-TYPE`	Doit être `application/json`	Oui

Si l’un de ces en-têtes est manquant, la requête est rejetée.

3. Corps de la requête

L’API GET ne nécessite pas de corps de requête
Seul le paramètre {id} dans l’URL est obligatoire

4. Réponse de l’API

Réponses d’erreur

401 – Non autorisé

Cette erreur se produit lorsque l’authentification échoue.

Causes possibles :

URL de la boutique manquante
Clé API manquante
URL de la boutique incorrecte
Clé API incorrecte
La clé API ne correspond pas à la boutique indiquée

403 – Cette action n’est pas autorisée

Cette erreur se produit lorsque :

La clé API n’a pas l’autorisation View
L’ID indiqué n’existe pas
La clé API ne dispose pas de droits d’accès suffisants

Chaque clé API peut recevoir les autorisations suivantes :

View
Create
Update
Delete

L’API GET nécessite l’autorisation View.

429 – Trop de requêtes

Cette erreur se produit lorsque la limite de débit est dépassée.

Limites actuelles :

Maximum 1 requête toutes les 5 minutes
Maximum 50 requêtes par jour

Réponse de succès

200 – Succès de l’API

La requête est valide
L’enregistrement a bien été récupéré
La réponse est renvoyée au format JSON

Exemple :

{
  "id": 1,
  "title": "New Volume Pricing",
  "status": true,
  "type": "quantity",
  "apply_customer": {
    "type": "all",
    "tags": []
  },
  "exclude_customer": {
    "type": "none",
    "tags": []
  },
  "apply_product": {
    "type": "all",
    "product_ids": [],
    "product_tags": [],
    "collection_ids": [],
    "apply_for_variants": false
  },
  "exclude_product": {
    "type": "none",
    "product_ids": [],
    "collection_ids": []
  },
  "discount_for_variants": [
    {
      "id": 8516448190631,
      "duplicated": false,
      "variant_pricing": true,
      "from_qty": "0",
      "from_amount": "0",
      "to_qty": "10",
      "to_amount": "0",
      "discount_groups": [
        {
          "name": "all",
          "type": "percent",
          "value": "10"
        }
      ],
      "variants": [
        {
          "id": 46747346763943,
          "duplicated": false,
          "from_qty": "0",
          "from_amount": "0",
          "to_qty": "10",
          "to_amount": "0",
          "discount_groups": [
            {
              "name": "all",
              "type": "percent",
              "value": "10"
            }
          ]
        }
      ]
    }
  ],
  "apply_market": {
    "type": "all",
    "handle": []
  },
  "discount_method": "variant",
  "discount_groups": [
    {
      "from_qty": "0",
      "from_amount": "0",
      "to_qty": "10",
      "to_amount": "0",
      "type": "percent",
      "value": "10"
    }
  ],
  "active_date": {
    "types": [],
    "start_at": "",
    "end_at": ""
  },
  "created_at": "2026-01-15T10:00:00",
  "updated_at": "2026-01-15T10:00:00"
}

Supprimer un enregistrement de tarification par volume

1. Point de terminaison

Pour supprimer un ou plusieurs enregistrements de tarification par volume existants :

DELETE https://wholesale.samita.io/api/v1/volume-pricings/{id}

{id} dans l’URL doit être un ID d’enregistrement valide, mais l’API supprime en réalité les enregistrements listés dans le paramètre ids (voir le corps de la requête ci-dessous), et non celui du segment d’URL.