Formats: what a drawing can be exported to

GET /formats lists the formats Export and Save can make: each one's name (as it goes in the path), media type, file name extension, what it is, and the industries it is for (industries: Packaging, SheetMetal, Glass …; empty for formats every industry uses, such as PDF and DXF). There is no body.

GET /formats?industry=Packaging lists only the formats for that industry and those for every industry, the industry's own first, as the desktop app's File › Export › Export… offers them (see Export by industry). The industry can be given in any case, or by a name people use for it (sheet metal, corrugated).

Example

GET /formats
X-API-KEY: your-api-key

[
  { "format": "Piq", "contentType": "text/plain", "extension": "piq", "description": "The drawing itself: ParametrIQ drawing text, still parametric.", "industries": [] },
  { "format": "Pdf", "contentType": "application/pdf", "extension": "pdf", "description": "PDF: layers as optional content, dieline layers as spot colours.", "industries": [] },
  { "format": "Cf2", "contentType": "application/octet-stream", "extension": "cf2", "description": "CF2 (Common File Format 2), for die-makers.", "industries": ["Packaging", "Labels", "Gaskets", "Foam", "Leather"] },
  …
  { "format": "Dxf", "contentType": "image/vnd.dxf", "extension": "dxf", "description": "DXF (AutoCAD 2013): each layer a DXF layer, dimensions as DIMENSIONs.", "industries": [] }
]

Format names can be given in any case in the path: /export/pdf and /export/Pdf are the same.

Dstv writes DSTV NC for steel fabrication machines, one file per piece cut out on the Cut layer, its header (order, drawing, grade, quantity, thickness, profile) from the drawing's classification: a drawing with one piece gives its .nc1 file, one with several a ZIP file (application/zip) holding a .nc1 file for each.

See also: API, Export.