Aller au contenu principal

Obtenir l'historique des commandes d'un utilisateur

Récupère et affiche l'historique des commandes d'un utilisateur.

Ce que fait cet exemple :

  • Connecte l'utilisateur
  • Récupère les commandes de l'utilisateur depuis le stockage orders

Prérequis :

  • Un PROJECT_URL et un APP_TOKEN valides pour l'API OneEntry.
  • Un utilisateur inscrit ayant des commandes

Remarques :

  • Les exemples gèrent les erreurs de façon minimale : ils lèvent une exception lorsqu'un appel renvoie un objet d'erreur.
  • Par défaut (isShell: true), le SDK renvoie un objet d'erreur au lieu de lever une exception : vérifiez donc le résultat, par ex. 'statusCode' in result. Avec isShell: false, il lève une exception, et vous gérez les erreurs avec try/catch. Voir Errors.
  • Le marqueur du stockage de commandes passé à Orders.getAllOrdersByMarker() doit correspondre à celui configuré dans votre projet OneEntry.

Documentation de la plateforme :

Référence du SDK :

Essayer en direct​

Exécutez cet exemple dans le bac à sable JS SDK. Lors de la première visite, connectez l'URL de votre projet et votre App Token, puis ouvrez :

Scénario​

1. Importer defineOneEntry et définir PROJECT_URL et APP_TOKEN​

import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'https://your-project.oneentry.cloud';
const APP_TOKEN = 'your-app-token';

2. Créer un client API avec defineOneEntry()​

const { AuthProvider, Orders } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

3. Se connecter avec AuthProvider.auth()​

const authData = [
  { marker: 'email_reg', value: 'your-email' },
  { marker: 'password_reg', value: 'your-password' },
];
const authResponse = await AuthProvider.auth('email', { authData });

if ('statusCode' in authResponse) {
  throw new Error(authResponse.message);
}

console.log(authResponse);
Résultat :
{
  "userIdentifier": "john@example.com",
  "authProviderIdentifier": "email",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR...pZCI6MTYsImF1dGhQ",
  "refreshToken": "1745494429101-...-2834edf8"
}

4. Obtenir toutes les commandes de l'utilisateur par marqueur de stockage de commandes avec Orders.getAllOrdersByMarker()​

const allOrders = await Orders.getAllOrdersByMarker('orders', 'en_US', 0, 30);

if ('statusCode' in allOrders) {
  throw new Error(allOrders.message);
}

console.log(allOrders);
Résultat :
{
  "items": [
    {
      "id": 118,
      "storageId": 1,
      "createdDate": "2026-06-06T11:38:43.011Z",
      "statusIdentifier": "upcoming",
      "statusLocalizeInfos": {
        "title": "Upcoming"
      },
      "formIdentifier": "order",
      "formData": [
        {
          "type": "string",
          "marker": "name",
          "value": "John Smith"
        }
      ],
      "attributeSetIdentifier": "order",
      "paymentStrategy": "once",
      "totalSum": "400",
      "totalSumRaw": "400",
      "currency": "USD",
      "paymentAccountIdentifier": "cash",
      "paymentAccountLocalizeInfos": {
        "title": "Cash"
      },
      "products": [
        {
          "id": 15,
          "title": "Orange ball",
          "sku": null,
          "previewImage": "[]",
          "price": 400,
          "quantity": 1,
          "isGift": false
        }
      ],
      "paymentUrl": null,
      "discountConfig": {
        "orderDiscounts": [],
        "productDiscounts": [],
        "coupon": null,
        "settings": {
          "allowStacking": false,
          "maxDiscountValue": null,
          "allowGiftStacking": false,
          "maxBonusPaymentPercent": null,
          "minBonusAmount": null,
          "minOrderAmountForBonus": null,
          "giftRefundPolicy": "KEEP_GIFT"
        },
        "additionalDiscountsMarkers": [],
        "totalRaw": 400,
        "totalSumWithDiscount": 400,
        "excludedGiftProductIds": [],
        "bonus": {
          "availableBalance": 0,
          "maxBonusDiscount": 0,
          "minBonusAmount": null,
          "minOrderAmountForBonus": null,
          "bonusApplied": 0
        },
        "bonusApplied": 0,
        "totalDue": 400
      },
      "isPartial": false,
      "isCompleted": false
    },
    {
      "id": 117,
      "storageId": 1,
      "createdDate": "2026-06-06T11:38:42.356Z",
      "statusIdentifier": "upcoming",
      "statusLocalizeInfos": {
        "title": "Upcoming"
      },
      "formIdentifier": "order",
      "formData": [
        {
          "type": "string",
          "marker": "name",
          "value": "John Smith"
        }
      ],
      "attributeSetIdentifier": "order",
      "paymentStrategy": "once",
      "totalSum": "400",
      "totalSumRaw": "400",
      "currency": "USD",
      "paymentAccountIdentifier": "cash",
      "paymentAccountLocalizeInfos": {
        "title": "Cash"
      },
      "products": [
        {
          "id": 15,
          "title": "Orange ball",
          "sku": null,
          "previewImage": "[]",
          "price": 400,
          "quantity": 1,
          "isGift": false
        }
      ],
      "paymentUrl": null,
      "discountConfig": {
        "orderDiscounts": [],
        "productDiscounts": [],
        "coupon": null,
        "settings": {
          "allowStacking": false,
          "maxDiscountValue": null,
          "allowGiftStacking": false,
          "maxBonusPaymentPercent": null,
          "minBonusAmount": null,
          "minOrderAmountForBonus": null,
          "giftRefundPolicy": "KEEP_GIFT"
        },
        "additionalDiscountsMarkers": [],
        "totalRaw": 400,
        "totalSumWithDiscount": 400,
        "excludedGiftProductIds": [],
        "bonus": {
          "availableBalance": 0,
          "maxBonusDiscount": 0,
          "minBonusAmount": null,
          "minOrderAmountForBonus": null,
          "bonusApplied": 0
        },
        "bonusApplied": 0,
        "totalDue": 400
      },
      "isPartial": false,
      "isCompleted": null
    },
    {
      "id": 116,
      "storageId": 1,
      "createdDate": "2026-06-06T11:38:21.644Z",
      "statusIdentifier": "upcoming",
      "statusLocalizeInfos": {
        "title": "Upcoming"
      },
      "formIdentifier": "order",
      "formData": [
        {
          "type": "string",
          "marker": "name",
          "value": "John Smith"
        }
      ],
      "attributeSetIdentifier": "order",
      "paymentStrategy": "once",
      "totalSum": "400",
      "totalSumRaw": "400",
      "currency": "USD",
      "paymentAccountIdentifier": "cash",
      "paymentAccountLocalizeInfos": {
        "title": "Cash"
      },
      "products": [
        {
          "id": 15,
          "title": "Orange ball",
          "sku": null,
          "previewImage": "[]",
          "price": 400,
          "quantity": 1,
          "isGift": false
        }
      ],
      "paymentUrl": null,
      "discountConfig": {
        "orderDiscounts": [],
        "productDiscounts": [],
        "coupon": null,
        "settings": {
          "allowStacking": false,
          "maxDiscountValue": null,
          "allowGiftStacking": false,
          "maxBonusPaymentPercent": null,
          "minBonusAmount": null,
          "minOrderAmountForBonus": null,
          "giftRefundPolicy": "KEEP_GIFT"
        },
        "additionalDiscountsMarkers": [],
        "totalRaw": 400,
        "totalSumWithDiscount": 400,
        "excludedGiftProductIds": [],
        "bonus": {
          "availableBalance": 0,
          "maxBonusDiscount": 0,
          "minBonusAmount": null,
          "minOrderAmountForBonus": null,
          "bonusApplied": 0
        },
        "bonusApplied": 0,
        "totalDue": 400
      },
      "isPartial": false,
      "isCompleted": false
    },
    {
      "id": 115,
      "storageId": 1,
      "createdDate": "2026-06-06T11:38:10.342Z",
      "statusIdentifier": "upcoming",
      "statusLocalizeInfos": {
        "title": "Upcoming"
      },
      "formIdentifier": "order",
      "formData": [
        {
          "type": "string",
          "marker": "name",
          "value": "John Smith"
        }
      ],
      "attributeSetIdentifier": "order",
      "paymentStrategy": "once",
      "totalSum": "400",
      "totalSumRaw": "400",
      "currency": "USD",
      "paymentAccountIdentifier": "cash",
      "paymentAccountLocalizeInfos": {
        "title": "Cash"
      },
      "products": [
        {
          "id": 15,
          "title": "Orange ball",
          "sku": null,
          "previewImage": "[]",
          "price": 400,
          "quantity": 1,
          "isGift": false
        }
      ],
      "paymentUrl": null,
      "discountConfig": {
        "orderDiscounts": [],
        "productDiscounts": [],
        "coupon": null,
        "settings": {
          "allowStacking": false,
          "maxDiscountValue": null,
          "allowGiftStacking": false,
          "maxBonusPaymentPercent": null,
          "minBonusAmount": null,
          "minOrderAmountForBonus": null,
          "giftRefundPolicy": "KEEP_GIFT"
        },
        "additionalDiscountsMarkers": [],
        "totalRaw": 400,
        "totalSumWithDiscount": 400,
        "excludedGiftProductIds": [],
        "bonus": {
          "availableBalance": 0,
          "maxBonusDiscount": 0,
          "minBonusAmount": null,
          "minOrderAmountForBonus": null,
          "bonusApplied": 0
        },
        "bonusApplied": 0,
        "totalDue": 400
      },
      "isPartial": false,
      "isCompleted": false
    }
  ],
  "total": 4
}

Exemple final​

// 1. Import defineOneEntry and define PROJECT_URL and APP_TOKEN
import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'https://your-project.oneentry.cloud';
const APP_TOKEN = 'your-app-token';

// 2. Create an API client
const { AuthProvider, Orders } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

// 3. Sign in with AuthProvider.auth()
const authData = [
  { marker: 'email_reg', value: 'your-email' },
  { marker: 'password_reg', value: 'your-password' },
];
const authResponse = await AuthProvider.auth('email', { authData });

if ('statusCode' in authResponse) {
  throw new Error(authResponse.message);
}

console.log(authResponse);

// 4. Get all user orders by order storage marker
const allOrders = await Orders.getAllOrdersByMarker('orders', 'en_US', 0, 30);

if ('statusCode' in allOrders) {
  throw new Error(allOrders.message);
}

console.log(allOrders);