Skip to main content

Changelog

All notable changes to the Seddi Public API are documented here.

Documentation — Viewer embed​

Documentation updates:

  • New Viewer guide for embedding a view-only recipe iframe

Documentation — Customizer recipe URL​

Documentation updates:

  • The Customizer guide describes embedding with recipe_url only

1.3.7 — Techpack profile and Customizer limits​

Contract updates:

  • POST /techpack-generator/v1 documents optional profile, a decorator profile slug from GET /data/v1/profiles. The service already accepted it.

Documentation updates:

  • When several points of measure share a name, Product Image and Techpack use the one on the same piece as the logo's region, then the closest to that region
  • The Customizer uses the first style record for a style or mockup load and does not offer another size
  • A saved recipe URL and the colorway-switch session last 30 minutes by default
  • With logos=true, the shopper can move, resize, align, rotate, reset, set technique, recolor, add, replace, or remove a graphic. Mockup mode can lock brand-logo regions

1.3.6 — Logo placement contract​

Contract updates:

  • logos is required on POST /product-image-generator/v1, with at least one graphic
  • fill is optional on Product Image and Techpack logos. Omit it to place with size and placement; the replay echoes fill: false. fill: true still fits the graphic inside its region
  • size and placement.at offsets are meters in the garment piece plane
  • placement.at.measure.from must be a point-of-measure name from GET /data/v1/points-of-measure
  • Product Image accepts optional profile, a decorator profile slug from GET /data/v1/profiles

Documentation updates:

  • Documented colorMap recoloring, the omitted-size default, placement.align values, PSD and TIFF sources, and the Rubber alias for Plastisol
  • Signed read URLs last 30 minutes. Logo files are stored under logos-for-generators/<cacheKey>/
  • Style Data lists region and point-of-measure names. An id is accepted only when the caller already has one
  • Product Image and Techpack return 404 when the style does not match. Generation calls may run up to 10 minutes
  • The Customizer guide covers colorway versus size, unsaved style and mockup edits, recipe URL rules, and mockup_id

1.3.5 — Clockwise logo rotation​

Contract updates:

  • Positive transform.rotation degrees turn Product Image and Techpack artwork clockwise. Scene and region-frame angles stay counterclockwise radians.

1.3.4 — Logo rotation​

Contract updates:

  • Product Image and Techpack logos accept optional transform.rotation: the orientation in the finished scene in degrees. Omit it or send 0 so the logo top points toward the top of the scene.
  • Techpack replay reports that rotation in degrees. The field was previously accepted and not applied; a number sent before this release was not a live radian rotation.

1.3.3 — requestedImages limit​

Contract updates:

  • Product Image and Techpack generators now accept at most 4 requestedImages items per request (was 16)

1.3.2 — Techpack 3D-only​

Contract updates:

  • Techpack generator is 3D-only; the styleType request field is removed and ignored if sent
  • Replayable request payloads no longer include styleType

1.3.1 — Plastisol technique​

Documentation updates:

  • Aligned the Product Image and Techpack guides so shared logos rules use identical wording and structure
  • Published technique list is now Plastisol, Waterbased, Glitter, HighDensity, Puff, HeatTransfer, DirectToGarment, Embroidery, Patch, Custom

Contract updates:

  • technique.name accepts "Plastisol"; examples and the replayable request use "Plastisol"
  • When technique is omitted, both generators default to "Plastisol" instead of "Waterbased"

1.3.0 — Decorator positioning and graphics limits​

Documentation updates:

  • Rewrote the Overview and docs home intro to describe the SEDDI Decorator API (graphics + blank style → images and techpack; catalog lookups free; billed for Product Creation)
  • Clarified that requestedImages allows up to 16 outputs across the four camera views (same view may be requested at different formats or resolutions)
  • Raised logos maximum from 8 to 16 graphics and documented the 15MB per-source file size limit

Contract updates:

  • Product Image and Techpack generators now accept up to 16 logos per request (was 8)

1.2.0 — Image and Techpack docs alignment​

Documentation updates:

  • Added first-class coverage for all three main offerings on the docs home page: Style Data, Product Image Creation, and Techpack Generation
  • Documented region aliases FIRST, SECOND, and THIRD for Product Image and Techpack APIs, including fallback behavior and priority ordering
  • Corrected generator contract details:
    • logos is required for product-image-generator requests
    • region is required unless placement.at is provided for techpack-generator logos
    • examples now use style region names or aliases consistent with Style Data

1.1.0 — Style Data​

Endpoints released:

  • GET /data/v1/brands — List brands
  • GET /data/v1/styles — List styles
  • GET /data/v1/colorways — List colorways for a style
  • GET /data/v1/sizes — List sizes for a style
  • GET /data/v1/profiles — List decorator profiles
  • GET /data/v1/regions — List region names for a style
  • GET /data/v1/points-of-measure — List points of measure for a style

1.0.0 — Initial release​

Authentication: API key via x-api-key header
Rate limit: 1,000 requests per minute per API key