ZSK Web API

CreateDST creates stitch data in the Tajima DST format (extension .dst) from text, from an existing design, or from both. Send it as an HTTP POST with a JSON body to StitchJob (see Overview) with "RequestType": "CreateDST", "ServerVersion": 3 and a valid WebApiLicense (see ZSK Web API License). Key names are case-sensitive, and integer fields need JSON integers ("DistanceMM": 2, not 2.5).

Input

• Text only: send Monograms and Needle, omit EmbroideryBase64.
• Existing design only: send EmbroideryType and EmbroideryBase64, omit Monograms (or send an empty list). No Needle list is needed.
• Design + text: send EmbroideryType, EmbroideryBase64, Monograms and Needle (with a TC or TBF design, "UseEmbroideryColors": 1 can replace Needle, see Colors). TextAlignment with a Mode places the text relative to the design (see TextAlignment to Design).

Text rules: without a design, every monogram needs a non-blank text; up to 9 monograms, one line each, 200 characters in total; FontSizeMM 5 to 50; FontFamily as listed by GetFontList (case-sensitive); UsedNeedle starts at 1. See Monograms.

EmbroideryType is required with every design and must be one of these values (case-sensitive):

Text, if present, is added to the design. CreateDST needs no needle assignment (SeqAssignmentJson), not even for DST or DSZ input.

Colors

• Needle sets the colors by position (first entry = needle 1); each monogram uses the entry in its UsedNeedle, so with text Needle needs at least that many entries. Red, Green, Blue: integers 0 to 255; other fields: strings.
• Only Red, Green, Blue and ColorName are passed on to the stitch generation; only CreateTC writes the other fields into its output. A DST file stores no thread colors, only color changes.
• With a TC or TBF design, "UseEmbroideryColors": 1 builds Needle from the design, replacing a sent list; UsedNeedle then selects an entry by position. See UseEmbroideryColors.

Response

On success: HTTP 200 with a JobResponseType with Success true and:

• RequestData: the created DST file, Base64-encoded.
• Info: widthMm, heightMm, maxX, maxY, minX, minY and numberOfStitches from the header of the created DST file. The other fields (also numberOfCuts, TC output only) are 0 or null.
• NeedleColor: TC or TBF design: the design needles, plus one entry per monogram numbered UsedNeedle + the highest design needle. DST or DSZ design: empty. Text only: one entry per monogram (its UsedNeedle and that Needle entry).
• NeedleSequence: TC or TBF design: the design sequence, then the monogram needles (numbered as in NeedleColor). DST or DSZ design: [1, 2, ..., n], one entry per color block of the created DST with at least 2 normal stitches. Text only: the UsedNeedle of each monogram.
• Time: processing times. PreviewData stays empty, also with WithPreview; use CreatePNG for a preview.

Info, NeedleColor, NeedleSequence and Time are JSON strings: parse each non-empty string a second time. Example for a DST design + text (formatted and shortened):

{
	"Info": "{ \"widthMm\": ..., \"heightMm\": ..., ..., \"numberOfStitches\": ..., ... }",
	"NeedleColor": "",
	"NeedleSequence": "[ 1, 2, 3, 4 ]",
	"PreviewData": "",
	"RequestData": "base64 encoded DST data",
	"Success": true,
	"Time": "{ ... }"
}

On error, Success is false and RequestData holds the error message.

Errors