Passer au contenu principal
GET
/
v3
/
gift-cards
/
checkProduct
/
{productId}
Vérifier les Détails du Produit
curl --request GET \
  --url https://api.oneclickdz.com/v3/gift-cards/checkProduct/{productId} \
  --header 'X-Access-Token: <api-key>'
{
  "data": {
    "types": [
      {
        "id": "<string>",
        "name": "<string>",
        "price": 123,
        "quantity": 123
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.oneclickdz.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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

​
Exemples

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