Le format est le squelette de la création de modèles. Il définit les paramètres essentiels à la mise en forme d’un document d’édition.

Le format englobe tous les éléments dont un sous-traitant a besoin pour fournir un produit fini. Il peut s’agir évidemment de la largeur et de la hauteur possibles pour une carte de visite, ou également de la taille d’une zone de marquage sur un t-shirt. Le format contient donc la description du produit fini et les règles de création de celui-ci.

À ce stade, les formats doivent être fournis à l’équipe Pixink afin de valider leur conformité et les possibilités d’intégration à l’atelier. Ci-dessous, la description d’un format tel qu’il est enregistré par l’atelier.

Note

Pour ajouter un format, nous acceptons un fichier CSV regroupant diverses descriptions de produits. Voici un lien de téléchargement du modèle de fichier .csv attendu.

Télécharger le modèle de fichier .csv

IMPORTANT

Le fichier CSV est un format de fichier pouvant être lu par Excel et tous ses dérivés tels que Google Docs, etc. Il est dépourvu de présentation et représente un tableau clé-valeur, autrement dit, des lignes et des colonnes. Et c’est tout. Toute modification du fichier, comme ajouter une page ou mettre en forme ce tableau, est proscrite pour garantir la bonne lisibilité de nos outils d’intégration. Nous n’acceptons que les formats .csv classiques !

---

Zoom sur le format

• display_name : Le nom affiché du produit, dans ce cas, “Carte de visite - Recto-Verso 85x55mm”.
• nb_page : Le nombre de pages du produit, dans ce cas, 1 pour une carte de visite recto-verso.
• rv : Un indicateur booléen indiquant si le produit est recto-verso (true) ou non (false).
• width : La largeur du produit en millimètres, dans ce cas, 85mm pour une carte de visite.
• height : La hauteur du produit en millimètres, dans ce cas, 55mm pour une carte de visite.
• default_ratio : Le ratio par défaut pour les mesures en millimètres, généralement 25.4 pour convertir les pouces en millimètres.
• dpi_echelle_1 : La résolution en points par pouce (dpi) à l’échelle 1.
• dpi_echelle_1_4 : La résolution en points par pouce (dpi) à l’échelle 1/4.
• fichier : Le nom du fichier associé au produit, laissé vide dans cet exemple.
• has_safe : Un indicateur booléen indiquant si le produit a une zone de sécurité définie (true) ou non (false).
• safe_top, safe_left, safe_bottom, safe_right : Les marges de sécurité en millimètres pour le haut, la gauche, le bas et la droite du produit.
• has_clip : Un indicateur booléen indiquant si le produit a une zone de découpe définie (true) ou non (false).
• clip_top, clip_left, clip_bottom, clip_right : Les marges de découpe en millimètres pour le haut, la gauche, le bas et la droite du produit.
• colors : La spécification des couleurs utilisées pour le produit, dans ce cas, “quadri” pour quadrichromie.
• tech : La technologie utilisée pour le produit, laissée vide dans cet exemple.
• output_support : Le support utilisé pour l’impression du produit, par exemple, “130g/m² couché brillant”.
• output_orientation : L’orientation de sortie du produit, paysage ou portrait.
• output_preset_format : Le format prédéfini du produit, dans ce cas, “Carte de visite - Recto-Verso 85x55mm”.
• output_reliure : La méthode de reliure utilisée pour le produit, par exemple, “Agraffe 2 points”.
• output_closed_format : Le format fermé du produit, par exemple, “210x297mm”.
• output_inside_support : Le support utilisé à l’intérieur du produit, par exemple, “90g/m² offset”.
• output_inside_pages : Le nombre de pages à l’intérieur du produit.
• output_outside_support : Le support utilisé à l’extérieur du produit.
• output_outside_pages : Le nombre de pages à l’extérieur du produit.
• output_selective_polish, output_selective_polish_3_d : Les indicateurs de polissage sélectif.
• output_hot_foil, output_hot_foil_3_d : Les indicateurs de dorure à chaud.
• fichier_exemple : Le nom du fichier d’exemple associé au produit, laissé vide dans cet exemple.
• contraintes_autres : Autres contraintes ou informations sur le produit, laissé vide dans cet exemple.

• Marges de sécuritées (has_safe)
• Format fini
• Fond perdu (has_clip)

Exemple de format délivré par l’API :

{
  "uuid": "•••••••-••••-••••-••••-••••••••", // uuid
  "display_name": "Business Card - 85x55mm Recto-Verso",
  "nb_page": 1,
  "rv": true,
  "width": 85,
  "height": 55,
  "default_ratio": 25.4,
  "dpi_echelle_1": 300,
  "dpi_echelle_1_4": 0,
  "fichier": "",
  "has_safe": true,
  "safe_top": 2,
  "safe_left": 2,
  "safe_bottom": 2,
  "safe_right": 2,
  "has_clip": true,
  "clip_top": 2,
  "clip_left": 2,
  "clip_bottom": 2,
  "clip_right": 2,
  "colors": "quadri",
  "tech": "",
  "output_support": "130g/m² couché brillant",
  "output_orientation": "paysage",
  "output_preset_format": "Business Card - 85x55mm Recto-Verso",
  "output_reliure": "Agraffe 2 points",
  "output_closed_format": "210x297mm",
  "output_inside_support": "90g/m² offset",
  "output_inside_pages": 2,
  "output_outside_support": "120g/m² offset",
  "output_outside_pages": 2,
  "output_selective_polish": "0",
  "output_selective_polish_3_d": "0",
  "output_hot_foil": "0",
  "output_hot_foil_3_d": "0",
  "fichier_exemple": "",
  "contraintes_autres": "",
  "created_at": "••••",
  "updated_at": "••••"
}