Vérifier les Détails du Produit

Obtenez les tarifs détaillés, les dénominations et le stock pour un produit spécifique

GET /v3/gift-cards/checkProduct/{productId}

Vérifier les Détails du Produit

cURL

curl --request GET \
  --url https://api.oneclickdz.com/v3/gift-cards/checkProduct/{productId} \
  --header 'X-Access-Token: <api-key>'

200

{
  "data": {
    "types": [
      {
        "id": "<string>",
        "name": "<string>",
        "price": 123,
        "quantity": 123
      }
    ]
  }
}

​

Vue d’ensemble

Retourne les types/dénominations de produit avec les tarifs en temps réel et la disponibilité du stock.

Les prix sont personnalisés selon votre compte. Supprimez cost avant de l’afficher aux utilisateurs.

​

Paramètres de chemin

productId · string · requis

ID du produit depuis l’endpoint /catalog

​

Réponse

data · object

Afficher propriétés

types · array

Tableau d’objets type/dénomination de produit

Afficher objet type

id · string

ID du type (à utiliser lors de la passation de commandes)

name · string

Nom du type/dénomination (ex. “100 DA”, “1000 DA”)

price · number

Votre prix (remise incluse)

quantity · number

Stock disponible (0 = rupture de stock)

​

Exemples

cURL

curl https://api.oneclickdz.com/v3/gift-cards/checkProduct/507f1f77bcf86cd799439011 \
  -H "X-Access-Token: YOUR_API_KEY"

​

Exemple de réponse

{
  "success": true,
  "data": {
    "productId": "507f1f77bcf86cd799439011",
    "productTitle": "PlayStation Network",
    "types": [
      {
        "id": "type_001",
        "name": "PSN 500 DA",
        "price": 490,
        "quantity": 150
      },
      {
        "id": "type_002",
        "name": "PSN 1000 DA",
        "price": 980,
        "quantity": 87
      },
      {
        "id": "type_003",
        "name": "PSN 2000 DA",
        "price": 1960,
        "quantity": 0
      }
    ]
  },
  "meta": {
    "timestamp": "2025-10-29T01:00:00.000Z"
  },
  "requestId": "req_1730163600_xyz789"
}

​

Appliquer votre marge bénéficiaire

function applyMarkup(types, markupPercent = 5) {
  return types
    .filter((t) => t.quantity > 0)
    .map((t) => ({
      id: t.id,
      name: t.name,
      price: Math.ceil(t.price * (1 + markupPercent / 100)),
      available: true,
    }));
}

// Usage
const customerPrices = applyMarkup(data.types, 5); // 5% markup

​

Bonnes pratiques

Vérifier le stock

Vérifiez quantity > 0 avant d’afficher

Appliquer une marge

Ajoutez votre marge bénéficiaire au price

Masquer le prix

N’affichez jamais le price en gros aux clients

Mettre à jour régulièrement

Rafraîchissez le stock périodiquement

​

Liens utiles

Obtenir le Catalogue

Parcourir tous les produits

Passer une Commande

Acheter un produit