Passer au contenu principal
GET
/
v3
/
gift-cards
/
list
Lister les Commandes
curl --request GET \
  --url https://api.oneclickdz.com/v3/gift-cards/list \
  --header 'X-Access-Token: <api-key>'

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 une liste paginée de toutes les commandes de cartes cadeaux et de produits numériques avec filtrage optionnel par date.

​
Paramètres de requête

​
page
integer
défaut:1
Numéro de page (minimum : 1)
​
pageSize
integer
défaut:20
Éléments par page (minimum : 1, maximum : 100)
​
from
string
Date de début (ISO 8601)
​
to
string
Date de fin (ISO 8601)

​
Exemples

curl "https://api.oneclickdz.com/v3/gift-cards/list?page=1&pageSize=20" \
  -H "X-Access-Token: YOUR_API_KEY"

​
Exemple de réponse

{
  "success": true,
  "data": {
    "items": [
      {
        "_id": "69001dc60c7d0ff0c542d96f",
        "quantity": 1,
        "price_per_card": 0,
        "time": "2025-10-28T01:35:02.224Z",
        "fulfilled_quantity": 1,
        "fulfilled_amount": 0,
        "cards": [
          {
            "value": "SANDBOX-CARD-1",
            "serial": "SANDBOX-1"
          }
        ],
        "status": "FULFILLED",
        "product": "string",
        "type": "string"
      },
      {
        "_id": "68fcdd7cd712569c624e05ee",
        "quantity": 1,
        "price_per_card": 2000,
        "time": "2025-10-25T14:23:56.515Z",
        "fulfilled_quantity": 0,
        "fulfilled_amount": 0,
        "cards": [],
        "status": "REFUNDED",
        "product": "6126393c6f57860f925a1983",
        "type": "6126393c6f57860f925a1984"
      }
    ],
    "pagination": {
      "page": 1,
      "pageSize": 5,
      "totalPages": 11,
      "totalResults": 55
    }
  },
  "meta": {
    "timestamp": "2025-10-29T00:36:53.030Z"
  }
}

​
Filtrage

​
Par plage de dates

curl "https://api.oneclickdz.com/v3/gift-cards/list?from=2025-10-01T00:00:00Z&to=2025-10-31T23:59:59Z" \
  -H "X-Access-Token: YOUR_API_KEY"

​
Filtrage côté client

// Filter by status
const fulfilled = orders.filter((o) => o.status === "FULFILLED");
const refunded = orders.filter((o) => o.status === "REFUNDED");

// Calculate totals
const totalRevenue = orders
  .filter((o) => o.status === "FULFILLED")
  .reduce((sum, o) => sum + o.fulfilled_amount, 0);

​
Liens utiles

Passer une Commande

Créer une nouvelle commande

Vérifier une Commande

Voir une commande spécifique