L'API d'inventaire de CSC LED
Branchez-vous dès aujourd'hui et accédez aux données de produits en temps réel pour votre site Web.
Générer votre jeton d'accès
Avant d'utiliser l'API ci-dessous, vous devrez générer votre jeton d'accès à l'aide de l'adresse courriel et du mot de passe enregistrés auprès de CSC LED.
Si vous n'êtes pas encore inscrit auprès de CSC LED pour accéder à notre API, veuillez communiquer avec info@csc-led.com et demander l'accès à l'API d'inventaire.
Une fois votre identifiant et votre mot de passe en main, l'étape suivante consiste à générer votre jeton d'accès en envoyant une requête POST à 'https://api.dev2024site.com/api/v1/token' avec l'adresse courriel et le mot de passe enregistrés pour l'accès à l'API, avec grant type = password.
Voici quelques exemples pour générer votre jeton d'accès :
var client = new RestClient("https://api.dev2024site.com/api/v1/token");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "text/plain");
request.AddParameter("text/plain", "grant_type=password&username=youremail@domain.com&password=password", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);Si vos identifiants sont corrects, vous recevrez une réponse JSON avec un code de réponse 200 (OK) (comme illustré ci-dessous).
{
"access_token": "123456789-0123456-cB9GVU9PNCGosw0edOKNPF-9wmGdPwaOvaoR2ehdazR_2Xr_ZxySf2e2oDxiMGeMtGUGRYXjaCWVjinmKrdOxQj6k2Gcr4Bts-g55GOG3s1iLNVSf0wb2_ZApi4WuIBQddUIuJ9v8kYnUoHqap95XO1zCe4xzxQNebQrwss5AHpwRANI1deVaZWPS3dX6s0-5gHdKoO1utFRZAvl36b7HBUjsejWcq1HLZv2dwsjx8xX8M885B7qrfjRO305", // updated access_token
"token_type": "bearer",
"expires_in": 3599,
"refresh_token": "12345678-99ae-4aa6-a278-7aa1c36721c9", // new refresh_token
"userName": "youremail@gmail.com",
"issued": "Mon, 22 Jan 2024 11:26:59 GMT",
"expires": "Mon, 22 Jan 2024 12:26:59 GMT"
}Si vos renseignements sont incorrects ou périmés, vous recevrez une erreur avec le statut 400 (Bad request), comme illustré ci-dessous.
{
"error": "invalid_grant",
"error_description": "Either email or password is incorrect"
}Actualiser votre jeton d'accès
Pour actualiser votre jeton d'accès, vous devrez envoyer votre access_token comme « Authorization » dans l'en-tête de votre requête avec le refresh_token courant, et définir grant_type à refresh_token comme paramètres du corps de la requête.
Par conséquent, les paramètres du corps de votre requête POST devraient maintenant contenir
grant_type=refresh_token&refresh_token=123456890-7ae6-4717-94ed-634550d75c62au lieu de
grant_type=password&username=youremail@domain.com&password=passwordExemple :
var client = new RestClient("https://api.dev2024site.com/api/v1/token");
client.Timeout = -1;
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "text/plain");
request.AddParameter("text/plain", "grant_type=refresh_token&refresh_token=123456890-7ae6-4717-94ed-634550d75c62",ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);Si votre demande d'actualisation du jeton réussit, vous recevrez un access_token et un refresh_token mis à jour. Utilisez-les pour récupérer des données de notre API ou pour actualiser votre jeton.
Si votre requête réussit, vous recevrez la réponse ci-dessous :
{
"access_token": "123456789-0123456-cB9GVU9PNCGosw0edOKNPF-9wmGdPwaOvaoR2ehdazR_2Xr_ZxySf2e2oDxiMGeMtGUGRYXjaCWVjinmKrdOxQj6k2Gcr4Bts-g55GOG3s1iLNVSf0wb2_ZApi4WuIBQddUIuJ9v8kYnUoHqap95XO1zCe4xzxQNebQrwss5AHpwRANI1deVaZWPS3dX6s0-5gHdKoO1utFRZAvl36b7HBUjsejWcq1HLZv2dwsjx8xX8M885B7qrfjRO305", // updated access_token
"token_type": "bearer",
"expires_in": 3599,
"refresh_token": "12345678-99ae-4aa6-a278-7aa1c36721c9", // new refresh_token
"userName": "youremail@gmail.com",
"issued": "Mon, 22 Jan 2024 11:26:59 GMT",
"expires": "Mon, 22 Jan 2024 12:26:59 GMT"
}Si le jeton d'actualisation fourni n'était pas correct, vous recevrez l'erreur ci-dessous.
{
"error": "invalid_grant"
}Si votre access_token ou votre refresh_token a expiré ou si vos droits d'accès à l'API ont été révoqués, vous recevrez l'erreur suivante :
{
"Message": "Authorization has been denied for this request."
}“Le jeton d'actualisation expire après 2 heures, tandis que le jeton d'accès expire après 1 heure. Vous devez conserver votre refresh_token afin d'actualiser l'access_token et de pouvoir générer un nouvel access_token et un nouveau refresh_token. Si votre jeton d'actualisation expire, vous devrez en demander un nouveau à l'aide de l'adresse courriel et du mot de passe enregistrés pour l'API, comme expliqué précédemment.“
Appeler notre API d'inventaire
| API | Description |
|---|---|
| GET api/v1.1/inventory/getInventoryList?pageNumber={pageNumber}&pageSize={pageSize} | Retrieve the full inventory list with all v1.1 fields, including Emergency Lighting updates. |
| GET api/v1.1/inventory/get?productNumber={productNumber} | Look up an individual product by product number and receive the expanded v1.1 field set. |
Remarque : Ces points de terminaison reflètent la plus récente version de notre API d'inventaire. Si vous utilisez encore une version antérieure, les champs nouvellement ajoutés peuvent ne pas apparaître dans vos réponses. Veuillez mettre à jour votre intégration pour assurer une compatibilité complète avec les fonctionnalités actuelles de l'API.
Quel inventaire est disponible?
Tous les produits CSC LED affichés sur notre site Web sont disponibles par l'entremise de cette API. Cela comprend les produits en liquidation, en fin de vie ou même inactifs. Si vous ne souhaitez pas inclure ces produits sur votre site Web, filtrez-les à l'aide des champs Clearance et Lifecycle Status inclus dans l'API.
Paramètres d'inventaire
Renseignements d'inventaire disponibles pour votre site Web.
| Nom | Description | Type |
|---|---|---|
| Amperage | Amperage | decimal |
| Base | Products base. | string |
| Battery Amp Hours | Battery amp hours | decimal |
| Battery Capacity | Capacity of the battery | string |
| Battery Recharge Time | Time required to recharge the battery | integer |
| Battery Type | Battery type used | string |
| Battery Voltage | Battery voltage | decimal |
| BeamAngle | Product's beam angle. | string |
| CartonHeight | The carton's height in inches. | string |
| CartonLength | The carton's length in inches. | string |
| CartonWeight | The carton's weight. | string |
| CartonWidth | The carton's width in inches. | string |
| CertificationListed | Product's certifications. | string |
| ColorTemperature | Product's colour temperature. | string |
| CRI | Product's CRI. | string |
| CSCcULNumber | Product's cUL number. | string |
| CSCDLCNumber | Product's DLC number. | string |
| Department | CSC LED's department assignment. | string |
| Dimmable | Product's dimmable setting. | string |
| Efficacy | Product's efficacy. | string |
| Finish | Product's finish material. | string |
| FinishColor | Product's finish colour. | string |
| GTIN | Product's GTIN. | string |
| HighResolutionPhotosList | The URL paths for the product's high resolution photos. | array |
| Housing | Product's housing material. | string |
| IESFilesList | The URL paths for the product's IES files. | array |
| InitialLumens | Product's initial lumens. | string |
| IPRating | Product's IP rating. | string |
| IsClearance | Indicates whether the product is classified as clearance. | boolean |
| Lamp Head Material | Material used for the lamp head housing | string |
| Lamp Head Watts | Power per lamp head | integer |
| Lamp Input Voltage | Input voltage for lamp heads | string |
| LifecycleActiveDate | The date in which CSC LED released the product. | string |
| LifecycleStatus | CSC LED's assigned lifecycle status. | string |
| LifeL70 | Product's Life (L70). | string |
| LowResolutionPhotoURL | The URL path for the product's low resolution photo. | string |
| MarketingMaterialsList | The URL paths for the product's Marketing Material files. | array |
| MasterCartonHeight | The master carton's height in inches. | string |
| MasterCartonLength | The master carton's length in inches. | string |
| MasterCartonWeight | The master carton's weight in pounds. | string |
| MasterCartonWidth | The master carton's width in inches. | string |
| Max Discharge Time | Maximum discharge time | integer |
| MetaDescription | The product's meta description as created by CSC LED. | string |
| MetaKeywords | The product's meta keywords as assigned by CSC LED. | string |
| Miscellaneous1URL | The URL path for the product's miscellaneous file 01. | string |
| Miscellaneous2URL | The URL path for the product's miscellaneous file 02. | string |
| MountingType | Product's mounting type. | string |
| Number of Lamp Heads | Number of individual lamp heads | integer |
| OperatingTemperature | Product's operating temperature range in celcius. | string |
| OperationInstructionsURL | The URL path for product's operation instruction file. | string |
| OtherList | The URL paths for the product's files categorized as other. | array |
| PowerCordLength | Included power cord length, if applicable. | string |
| PowerFactor | Product's power factor. | string |
| ProductDescription | Short product description. | string |
| ProductId | Our unique CSC LED product Id. | integer |
| ProductNumber | Our unique CSC LED product number. | string |
| ProductSeries | The CSC LED product series this product belongs to. | string |
| ProductType | CSC LED's product type classification. | string |
| QtyPerCarton | The number of products within each carton. | string |
| QtyPerMasterCarton | The number of cartons within each master carton. | integer |
| QtyPerSkid | The number of products which can be stored on a single skid. | string |
| SpecSheetFilesList | The URL paths for the product's Spec Sheet files. | array |
| StockImmediate | Total available stock at AB, BC and ON warehouses. | integer |
| StockOnHand | Total available stock at AB, BC and ON warehouses, inclusive of branch transfers. | integer |
| SuggestedTrade | Suggested trade unit price. | decimal number |
| TechnicalDocumentsList | The URL paths for the product's Technical Document files. | array |
| THD | Product's THD as percentage. | string |
| Total Lumens | Total light output produced | integer |
| TotalAvailableForSale | Total available stock at AB, BC and ON warehouses, inclusive of branch transfers and incoming restock orders. | integer |
| TradeSize | The product's approximate size for website filtering. | string |
| UnitGrossWeight | The product's gross weight. | string |
| UnitHeight | The product's height in inches. | string |
| UnitLength | The product's length in inches. | string |
| UnitWidth | The product's width in inches. | string |
| UPC | Product's UPC. | string |
| Voltage | Product's voltage. | string |
| Watts | Product's wattage. | string |
| WebsiteDescription | Product's full website description. | string |
| WebsiteName | The name of the product. | string |
| YourPrice | Price per unit. | decimal number |
Journal des modifications de l'API d'inventaire
| Date | Version | Résumé des mises à jour |
|---|---|---|
| 9 oct. 2025 | v1.1 |
|
| 1er sept. 2020 | v1 | Version initiale de l'API d'inventaire |
'%20d='M34.017,41.99l-20,0.019c-4.4,0.004-8.003-3.592-8.008-7.992l-0.019-20%20c-0.004-4.4,3.592-8.003,7.992-8.008l20-0.019c4.4-0.004,8.003,3.592,8.008,7.992l0.019,20%20C42.014,38.383,38.417,41.986,34.017,41.99z'/%3e%3cradialGradient%20id='yOrnnhliCrdS2gy~4tD8mb'%20cx='11.786'%20cy='5.54'%20r='29.813'%20gradientTransform='matrix(1%200%200%20.6663%200%201.849)'%20gradientUnits='userSpaceOnUse'%3e%3cstop%20offset='0'%20stop-color='%234168c9'/%3e%3cstop%20offset='.999'%20stop-color='%234168c9'%20stop-opacity='0'/%3e%3c/radialGradient%3e%3cpath%20fill='url(%23yOrnnhliCrdS2gy~4tD8mb)'%20d='M34.017,41.99l-20,0.019c-4.4,0.004-8.003-3.592-8.008-7.992l-0.019-20%20c-0.004-4.4,3.592-8.003,7.992-8.008l20-0.019c4.4-0.004,8.003,3.592,8.008,7.992l0.019,20%20C42.014,38.383,38.417,41.986,34.017,41.99z'/%3e%3cpath%20fill='%23fff'%20d='M24,31c-3.859,0-7-3.14-7-7s3.141-7,7-7s7,3.14,7,7S27.859,31,24,31z%20M24,19c-2.757,0-5,2.243-5,5%20s2.243,5,5,5s5-2.243,5-5S26.757,19,24,19z'/%3e%3ccircle%20cx='31.5'%20cy='16.5'%20r='1.5'%20fill='%23fff'/%3e%3cpath%20fill='%23fff'%20d='M30,37H18c-3.859,0-7-3.14-7-7V18c0-3.86,3.141-7,7-7h12c3.859,0,7,3.14,7,7v12%20C37,33.86,33.859,37,30,37z%20M18,13c-2.757,0-5,2.243-5,5v12c0,2.757,2.243,5,5,5h12c2.757,0,5-2.243,5-5V18c0-2.757-2.243-5-5-5H18z'/%3e%3c/svg%3e)
