Importer vos données via notre API

Votre Technical Account Manager vous accompagne tout au long du processus d’intégration API, en vous fournissant les moyens d’authentification (bearer tokens) pour les environnements sandbox (test) et production.

Il vous accompagne tout au long du projet, depuis la réunion de lancement jusqu’à la mise en production, en passant par le mapping des données, la mise en place des connexions (réalisée en interne par vos équipes ou avec l’appui d’un intégrateur partenaire), puis les phases de test.

💡 Besoin d'aide? Contactez votre Technical Account Manager:

• Clotilde Bazin - clotilde.bazin@fairlymade.com
• Guillaume Babule - guillaume.babule@fairlymade.com

En fonction des besoins de votre organisation et de la disponibilité de vos équipes IT, vous avez le choix entre trois niveaux de support durant la phase de mise en place API.

👉 Planifier un rendez-vous avec votre Technical Account Manager ici pour obtenir plus d’informations.

1.2 Exigences techniques pour la mise en œuvre

Ordre d'importation des données

Respectez impérativement cet ordre pour créer vos données :

Cela garantit la cohérence des relations entre les entités et évite les erreurs d’importation.

Identifiants Système

Il est essentiel de comprendre comment le système identifie vos données :

• Produits : identifiés de manière unique via la combinaison productRef + productCollectionRef + productColorCode

• Composants : identifiés de manière unique par la componentRef (si besoin, concaténez d’autres champs pour garantir l’unicité selon les catégories/saisons)

Paramètres obligatoires pour les appels API

Chaque appel API doit inclure :

• votre bearer token (clé d’authentification personnelle). Pour l’obtenir, connectez-vous à la plateforme, allez dans My Account, puis dans l’onglet Token API, ou adressez-vous à votre référent IT,

• un code de lot d’importation "ImportationBatch" (pour identifier les blocs de données)

• le type de projet "ProjectType" (en lien avec votre contrat Fairly Made, ex. : Standard ou AGEC)

Respectez la limite de 150 requêtes par seconde. Attendez entre 2 et 5 secondes entre la création de différents types d’objets.

Gestion des Environnements

Vous disposez de deux environnements distincts :

• Sandbox : pour les tests, vide au départ, destiné à accueillir vos données de test

• Production : pour les données en conditions réelles

Chaque environnement possède son propre bearer token.

1.3 Tests et Documentation

Utiliser Postman pour vos Tests

Vous pouvez tester votre intégration API via Postman avant de passer en production. Consultez la documentation Postman pour les instructions de configuration.

Jeux de Tests

Pour comprendre les données attendues sur chaque endpoint, vous pouvez accéder à des jeux de test via ce lien. Ces exemples vous aideront à structurer correctement vos appels API.

Vous pouvez soit :

• télécharger nos collections de test Postman à importer directement dans l’application Postman,

• ou consulter nos fichiers JSON d’exemple à titre de référence.

API Documentation Access

Accédez à la documentation technique complète ici. Elle contient des exemples de payloads et des cas d’usage concrets pour tous les endpoints, afin de vous aider à structurer vos appels API correctement.