Une API REST documentée, ouverte et testable pour brancher votre système d'impression
Vous évaluez les imprimeurs capables d'absorber le flux de commandes de votre plateforme — ERP, plateforme d'achats, intranet, boutique de marque, portail d'agence, configurateur maison. Vous voulez vérifier par vous-même, avant tout échange commercial, qu'une intégration est techniquement réaliste. Cette page existe précisément pour ça : tout ce qu'il vous faut pour décider est public, explorable maintenant, sans formulaire.
🔓 Ce qui est ouvert, et pourquoi c'est rare
L'évaluation d'un imprimeur partenaire bute presque toujours sur le même mur : « API disponible sur demande », « contactez-nous pour la documentation », « réservé aux comptes validés ». À ce stade vous n'avez encore rien à montrer à votre équipe, et chaque tour de validation prend une semaine.
Nous avons pris l'inverse comme parti. La documentation est publique, versionnée, explorable :
- Spécification OpenAPI 3.0.3 téléchargeable. C'est le contrat de l'API, intégrable directement dans vos outils (générateurs de client, postman, scénarios de test).
- Swagger UI pour explorer chaque ressource, lire les schémas requêtes/réponses, et tester en interface.
- ReDoc pour la lecture longue, par section.
- Tutoriel de démarrage et guide de migration v0.1 → v0.2.
-
Authentification par token (
Authorization: Token …), HTTPS imposé, HTTP non-SSL désactivé. - Réponses JSON et XML au choix.
Concrètement, vous pouvez ouvrir la documentation technique complète maintenant, lire les schémas, et construire mentalement votre intégration avant même de nous parler. C'est le contrat implicite de cette page : tout ce qu'un évaluateur technique a besoin de voir pour qualifier ou disqualifier un fournisseur est accessible sans nous solliciter.
⚙️ Ce que l'API permet de faire
Sur l'ensemble du catalogue, l'API expose le cycle de commande complet :
Découvrir et configurer
Accès aux configurateurs produit : familles, formats, supports, finitions, quantités, options de personnalisation. La structure exposée par l'API est celle qui est réellement utilisée en production, pas une vue simplifiée.
Calculer un prix
Endpoint de tarification avec prise en compte native des remises grand-compte (remise_grand_compte_ht). Pas de tarif catalogue à synchroniser de votre côté : le prix renvoyé par l'API est le prix qui s'applique au compte authentifié, remises incluses.
Créer un panier et passer commande
Cycle panier → validate → commande, sous token. Le panier porte les lignes produit configurées ; la validation déclenche le passage en commande effective.
Consulter ses commandes
Endpoints commande en GET pour récupérer l'état des commandes passées via l'API.
📐 Le périmètre catalogue : grand format, signalétique, adhésifs, et au-delà
C'est le second point différenciant, et il est observable directement dans le schéma OpenAPI. Les APIs des plus gros acteurs européens du web-to-print sont historiquement scopées petit format (flyers, cartes, brochures, papeterie), parce qu'elles viennent de l'impression à la demande livre/marketing. Notre API est nativement scopée grand format et signalétique : adhésifs, affiches, bâches, panneaux — exactement les supports que pilote un réseau de points de vente, une chaîne retail, un acteur de la signalétique BTP ou événementielle. Pour les très grands formats supérieurs à 150 × 200 cm, voir aussi notre calepinage grand format.
C'est un wedge prouvable, pas un argument marketing : ouvrez le schéma, les familles sont là.
🇫🇷 Côté production : ce qu'il y a derrière l'API
Une API ouverte sur une production fragile n'a aucune valeur. Derrière les endpoints :
- Un imprimeur français (made in France), avec une production française multi-ateliers répartie sur plusieurs sites spécialisés en région Rhône-Alpes.
- Une compétence forte sur grand format, signalétique, PLV, adhésifs, cohérente avec le périmètre exposé par l'API — l'un valide l'autre.
- L'héritier d'une tradition d'imprimerie de plus de 60 ans dans le bassin rhônalpin, au sein d'un groupe industriel structuré.
🛠️ Ce que votre intégration va probablement ressembler
Pour un évaluateur, voici la séquence type d'une intégration côté votre système :
-
1
Exploration en autonomie. Vous explorez la doc (sans nous contacter) et identifiez les endpoints qui correspondent à votre cas — typiquement
configuration_produit,tarification,panier,commande. -
2
Obtention d'un token partenaire. Après un échange technique initial qui permet de cadrer votre périmètre d'intégration.
-
3
Construction de la couche d'intégration côté votre système : mapping entre vos références produit internes et les configurateurs de l'API, appel de tarification au moment de la validation commande chez vous, appel de création de commande au moment du déclenchement production.
-
4
Validation sur un périmètre restreint (quelques références, un site pilote, commandes pilotes) avant de généraliser.
-
5
Passage en production, avec un interlocuteur dédié côté 123IMPRIM sur la phase de montée en charge.
Pour les besoins encadrés par marché public, consultation ou cadre d'achats, voir aussi notre page devis et appels d'offres.
❓ Questions fréquentes
▸ Où se trouve la documentation ?
Sur api.123imprim.com. Vous y accédez sans formulaire : spécification OpenAPI, exploration via Swagger UI, lecture longue via ReDoc, tutoriel de démarrage, guide de migration de version.
▸ Quelle est la version courante de l'API ?
v0.2. Un guide de migration v0.1 → v0.2 est publié, signe que l'API est maintenue dans la durée et que les évolutions de version sont documentées.
▸ Quel type d'authentification ?
Token partenaire à passer en en-tête Authorization: Token …. HTTPS imposé, HTTP désactivé.
▸ Quels formats de réponse ?
JSON et XML, au choix selon l'en-tête Accept.
▸ Quel périmètre catalogue est adressable par l'API ?
L'ensemble du catalogue 123IMPRIM est programmé pour être adressable par l'API. Le périmètre exposé évolue au fil des releases ; l'état courant est visible directement dans le schéma OpenAPI. Au moment d'écrire ces lignes, les familles grand format et signalétique (adhésifs, affiches, bâches, panneaux) sont exposées.
▸ La tarification grand-compte est-elle gérée par l'API ?
Oui, nativement. La réponse de l'endpoint de prix porte un champ dédié (remise_grand_compte_ht) : pas de tarif catalogue à maintenir de votre côté, pas de recalcul à faire — le prix renvoyé est le prix appliqué à votre compte.
▸ Y a-t-il un environnement de test ?
La documentation et le Swagger sont accessibles publiquement pour exploration et lecture. Les modalités précises de validation (sandbox dédiée ou commandes pilotes en début d'intégration) se cadrent lors de l'échange technique, en fonction de votre environnement.
▸ Comment obtenir un token ?
Le token partenaire est émis après l'échange technique initial, qui permet de cadrer votre périmètre d'intégration. Décrivez-nous votre système amont et vos volumes pour déclencher cette étape.
▸ Quel volume minimum pour mettre en place une connexion API ?
La connexion API se justifie dès que le volume de commandes récurrentes rendrait la saisie manuelle coûteuse côté votre équipe. Ce point se cadre lors de l'échange technique.
💡 La connexion programmatique complète est un des modes possibles, pas un prérequis. Pour découvrir l'offre complète et les modes de centralisation et d'automatisation des commandes d'impression (échange de fichier, connecteur boutique, intégration au système d'achats), revenez à la page-mère du service.
Parlons de votre intégration
Décrivez-nous votre système amont, votre catalogue, vos volumes et vos contraintes de marque blanche.
On vous indique en retour ce qui est connectable,
sur quel périmètre, et avec quel niveau d'effort côté
votre équipe.