Passer au contenu principal

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

Passez des commandes de cartes-cadeaux après avoir vérifié la disponibilité des produits. Les commandes sont traitées instantanément et retournent un orderId pour le suivi.
Les commandes sont définitives une fois passées. Vérifiez le stock et le solde en premier.

​
Référence API

POST /v3/gift-cards/placeOrder

Documentation complète de l’endpoint

​
Passer une commande

import requests
import os

def place_order(product_id, type_id, quantity):
    response = requests.post(
        'https://api.oneclickdz.com/v3/gift-cards/placeOrder',
        headers={
            'Content-Type': 'application/json',
            'X-Access-Token': os.getenv('API_KEY')
        },
        json={
            'productId': product_id,
            'typeId': type_id,
            'quantity': quantity
        }
    )

    result = response.json()

    if not response.ok:
        raise Exception(result.get('message', 'Order failed'))

    return result['data']['orderId']

# Usage
order_id = place_order('507f1f77bcf86cd799439011', 'type_001', 2)
print(f"Order placed: {order_id}")

​
Réponse

{
  "success": true,
  "data": {
    "orderId": "6901616fe9e88196b4eb64b3"
  }
}

​
Gestion des erreurs

try:
    order_id = place_order(product_id, type_id, quantity)
    print(f"Success: {order_id}")
except Exception as error:
    if 'stock' in str(error):
        print("Out of stock")
    elif 'balance' in str(error):
        print("Insufficient balance")
    else:
        print(f"Order failed: {error}")

​
Étapes suivantes

Après avoir passé une commande :
  1. Sauvegardez l’orderId - Vous en aurez besoin pour vérifier le statut
  2. Suivez la commande - Vérifiez le statut jusqu’à l’exécution
  3. Livrez les cartes - Envoyez les codes à votre client

Suivre le statut de la commande

Surveiller la commande jusqu’à son achèvement

Vérifier les produits

Vérifier le stock avant de commander