Lister les articles

GET /articles

Retourne la liste des articles de vos activités autorisées.

Paramètres de requête

Paramètre	Type	Description
filter	string	Expression de filtrage QueryKit
sort	string	Expression de tri. Défaut : par articleReference

Limite

100 résultats maximum par requête.

Filtrage automatique

• Seuls les articles de vos activités autorisées (client_context) sont retournés
• Les articles internes (référence commençant par *) sont exclus automatiquement

Structure de la réponse

Tableau JSON d’objets Article. Chaque article inclut :

• Tous les champs de l’article (voir Créer des articles)
• dateCreated, dateLastUpdated : horodatages de création et de dernière mise à jour
• id : identifiant technique (égal à articleReference)
• barcodes : liste des codes-barres associés (chaque code-barre inclut un champ id)
• alcool : données alcool si renseignées — champ omis (absent) si l’article n’a pas de données alcool
• logisticalVariants : liste des variantes logistiques (chaque VL inclut id, dateCreation, dateLasteUpdate)

Exemple de requête

cURL

curl -X GET "https://api.ezyconnect.com/articles?filter=articleFamily==%22TEXTILE%22&sort=articleReference" \
  -H "Authorization: Bearer YOUR_TOKEN"

JavaScript

const params = new URLSearchParams({
  filter: 'articleFamily == "TEXTILE"',
  sort: "articleReference"
});

const response = await fetch(`https://api.ezyconnect.com/articles?${params}`, {
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

const articles = await response.json();
console.log(articles);

Python

import requests

url = "https://api.ezyconnect.com/articles"
headers = {"Authorization": "Bearer YOUR_TOKEN"}
params = {
    "filter": 'articleFamily == "TEXTILE"',
    "sort": "articleReference"
}

response = requests.get(url, headers=headers, params=params)
articles = response.json()
print(articles)

C#

using System.Net.Http;
using System.Net.Http.Json;

var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", "YOUR_TOKEN");

var url = "https://api.ezyconnect.com/articles"
        + "?filter=articleFamily%3D%3D%22TEXTILE%22"
        + "&sort=articleReference";

var articles = await client.GetFromJsonAsync<object[]>(url);

Java

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

String filter = URLEncoder.encode("articleFamily == \"TEXTILE\"", StandardCharsets.UTF_8);
String url = "https://api.ezyconnect.com/articles?filter=" + filter + "&sort=articleReference";

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create(url))
    .header("Authorization", "Bearer YOUR_TOKEN")
    .GET()
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Exemple de réponse

[
  {
    "activityCode": "BIO",
    "dateCreated": "2024-11-15T08:30:00.000000",
    "dateLastUpdated": "2024-11-15T08:30:00.000000",
    "activityName": "BIO",
    "articleReference": "ART-001",
    "longArticleDescription": "T-shirt coton bio taille M bleu",
    "shortArticleDescription": "T-shirt M bleu",
    "nomenclatureManaged": false,
    "articleType": 0,
    "netWeightPerUVC": 200,
    "grossWeightPerUVC": 250,
    "lengthPerUVC": 300,
    "widthPerUVC": 200,
    "heightPerUVC": 30,
    "quantityPerPCB": 12,
    "quantityPerSPCB": 0,
    "grossWeightPerPCB": 3500,
    "lengthPerPCB": 0,
    "widthPerPCB": 0,
    "heightPerPCB": 0,
    "grossWeightPerSPCB": 0,
    "lengthPerSPCB": 0,
    "widthPerSPCB": 0,
    "heightPerSPCB": 0,
    "storageMethod": "001",
    "preferredStorageAisle": "E01",
    "preparationMethod": "001",
    "articleAnalysisCode": "E",
    "articleFamily": "TEXTILE",
    "saleExpirationDate": false,
    "uvcQuantityPerCartonOrPalette": 9999,
    "weightPerCartonOrPalette": 0,
    "lengthPerCartonOrPalette": 0,
    "widthPerCartonOrPalette": 0,
    "heightPerCartonOrPalette": 0,
    "topHazardousMaterial": false,
    "topAlcoholArticle": false,
    "topConsignedArticle": false,
    "disableProduit": false,
    "barcodes": [
      {
        "code": "3760001234567",
        "isPrimary": true,
        "barcodeUnit": "UVC",
        "barcodeQuantity": 1,
        "logisticalVariantCode": "10",
        "disabled": false,
        "id": "3760001234567"
      },
      {
        "code": "03760001234567",
        "isPrimary": false,
        "barcodeUnit": "PCB",
        "barcodeQuantity": 12,
        "logisticalVariantCode": "20",
        "disabled": false,
        "id": "03760001234567"
      }
    ],
    "logisticalVariants": [
      {
        "id": "NULL_STRING",
        "dateCreation": "2024-11-15T08:30:00.000000",
        "dateLasteUpdate": "2024-11-15T08:30:00.000000",
        "logisticalVariantCode": "10",
        "lvTypeCode": "UVC",
        "baseLv": true,
        "packagingLv": false,
        "managementLv": false,
        "quantityInSubpackagingLv": 1,
        "quantityInBaseLv": "1",
        "netWeight": 200,
        "grossWeight": 250,
        "height": 30,
        "width": 200,
        "depth": 300,
        "volume": 0,
        "standardPrice": 0,
        "checkAtReceipt": false,
        "repackingAtReceipt": false,
        "subpackagingLvNbConstitutingLayer": 0,
        "heightLayer": 0,
        "kit": false,
        "newLv": false,
        "disableVl": false,
        "barcodes": []
      },
      {
        "id": "NULL_STRING",
        "dateCreation": "2024-11-15T08:30:00.000000",
        "dateLasteUpdate": "2024-11-15T08:30:00.000000",
        "logisticalVariantCode": "30",
        "lvTypeCode": "SUP",
        "baseLv": false,
        "packagingLv": true,
        "managementLv": false,
        "subpackagingLvCode": "10",
        "quantityInSubpackagingLv": 9999,
        "quantityInBaseLv": "9999",
        "netWeight": 0,
        "grossWeight": 0,
        "height": 0,
        "width": 0,
        "depth": 0,
        "volume": 0,
        "standardPrice": 0,
        "checkAtReceipt": false,
        "repackingAtReceipt": false,
        "hdTypeCode": "434",
        "locationSizeCode": "434",
        "storageGroupCode": "E01",
        "preparationGroupCode": "001",
        "subpackagingLvNbConstitutingLayer": 0,
        "heightLayer": 0,
        "kit": false,
        "newLv": true,
        "disableVl": false,
        "barcodes": []
      }
    ],
    "id": "ART-001"
  }
]

Obtenir un article spécifique

GET /articles/{articleReference}

Retourne un article unique par sa référence.

curl -X GET "https://api.ezyconnect.com/articles/ART-001" \
  -H "Authorization: Bearer YOUR_TOKEN"

Retourne une erreur 404 si l’article n’existe pas ou n’est pas dans vos activités autorisées.