Design Atoms API
Use this API when you are working with Design Atoms SDK to build your own editor interface.
To learn more about Design Atoms, refer to the Design Atoms documentation.
Api Clients
.Net Client
You can install it from Nuget as follows:
Install-Package Aurigma.DesignAtomsApi.ApiClient
Angular Client
This client is compatible with Angular applications only. It won't work with NodeJS or other frontend JS frameworks. You can install the package to your Angular application as follows:
npm install @aurigma/ng-design-atoms-api-client
NodeJS Client (Axious)
This client can be used in a wide range of JavaScript applications. To make API calls, it uses Axios - a popular HTTP library. Although it is possible to use it in both frontend and backend projects, the primary target platform for this library is NodeJS.
Install the package as follows:
npm install @aurigma/axios-design-atoms-api-client
PHP Client
PHP client can be installed through composer as follows:
composer require aurigma/php-design-atoms-client
BuildInfo
These endpoints can be used to get the technical information about the service such as version, build date and similar. They are also useful for a quick test whether the service is available. All of them are working in the same way and return the same information - use the HEAD or GET flavor of this endpoint based on your preference.
HeadInfo
Get assembly build info.
Request
HEAD /api/atoms/v1/info
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
Headers | |||
X-Aurigma-Version | string | A version number |
|
X-Aurigma-Build-Date | string | A build date (UTC) |
|
X-Aurigma-Configuration | string | A build configuration (Debug | Release) |
|
X-Aurigma-App-Name | string | A service name |
|
X-Aurigma-Design-Atoms-Version | string | An Aurigma.DesignAtoms version number |
|
X-Aurigma-Design-Atoms-Model-Version | string | An Aurigma.DesignAtoms.Model version number |
GetInfo
Get assembly build info.
Request
GET /api/atoms/v1/info
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 |
|
Success |
DesignAtomsCompatibility
These endpoints are used in compatibility purposes
CssFonts
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/cssfonts
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
401 | Unauthorized |
||
403 | Forbidden |
Fonts
Request
GET /api/atoms/v1/tenants/{tenantId}/api/ccviewer/fonts/{psName}
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
*psName | path |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
GetColorPreview
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/GetColorPreview
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
GetColorPreviews
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/GetColorPreviews
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
GetCssFont
Request
GET /api/atoms/v1/tenants/{tenantId}/api/ccviewer/GetCssFont[?fontKey]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
fontKey | query |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
GetFallbackFonts
Request
GET /api/atoms/v1/tenants/{tenantId}/api/ccviewer/GetFallbackFonts
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
GetImageSize
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/GetImageSize
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 |
|
Success |
|
401 | Unauthorized |
||
403 | Forbidden |
GetShapeBounds
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/GetShapeBounds
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 |
|
Success |
|
401 | Unauthorized |
||
403 | Forbidden |
GetWatermarkItems
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/GetWatermarkItems
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
Img
Request
GET /api/atoms/v1/tenants/{tenantId}/api/ccviewer/img[?f&w&h&cmyk&rgb&grayscale&target&sq&effect&kp&color&obm&oo&alphaMask&page&colorizeColor&rw&rh]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
f | query | |||
w | query | |||
h | query | |||
cmyk | query | |||
rgb | query | |||
grayscale | query | |||
target | query | |||
sq | query | |||
effect | query | |||
kp | query | |||
color | query | |||
obm | query | |||
oo | query | |||
alphaMask | query | |||
page | query | |||
colorizeColor | query | |||
rw | query | |||
rh | query |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
304 | Not Modified |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
GetLicense
Request
GET /api/atoms/v1/tenants/{tenantId}/api/ccviewer/license
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
Pth
Request
GET /api/atoms/v1/tenants/{tenantId}/api/ccviewer/pth[?f]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
f | query |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
304 | Not Modified |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
Resource
Request
GET /api/atoms/v1/tenants/{tenantId}/api/ccviewer/resource[?image]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
image | query |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
Svg
Request
GET /api/atoms/v1/tenants/{tenantId}/api/ccviewer/svg[?f&w&h&cmyk&rgb&grayscale&target&sq&effect&kp&color&obm&oo&alphaMask&page&colorizeColor&rw&rh]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
f | query | |||
w | query | |||
h | query | |||
cmyk | query | |||
rgb | query | |||
grayscale | query | |||
target | query | |||
sq | query | |||
effect | query | |||
kp | query | |||
color | query | |||
obm | query | |||
oo | query | |||
alphaMask | query | |||
page | query | |||
colorizeColor | query | |||
rw | query | |||
rh | query |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
304 | Not Modified |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
Txt
Request
GET /api/atoms/v1/tenants/{tenantId}/api/ccviewer/txt[?f]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
f | query |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
304 | Not Modified |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
UpdateArchedTextItemHandler
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/UpdateArchedTextItemHandler
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateAutoScaledTextItemHandler
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/UpdateAutoScaledTextItemHandler
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateBarcodeItemHandler
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/UpdateBarcodeItemHandler
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateBoundedTextItemHandler
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/UpdateBoundedTextItemHandler
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateByColorData
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/UpdateByColorData
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateByMultiCallRequest
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/UpdateByMultiCallRequest
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateCurvedTextItemHandler
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/UpdateCurvedTextItemHandler
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateImageItemHandler
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/UpdateImageItemHandler
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdatePathBoundedTextItemHandler
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/UpdatePathBoundedTextItemHandler
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdatePlainTextItemHandler
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/UpdatePlainTextItemHandler
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateShapeItemHandler
Request
POST /api/atoms/v1/tenants/{tenantId}/api/ccviewer/UpdateShapeItemHandler
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*tenantId | path | |||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
DesignAtomsImages
These endpoints are used to manipulate images via Design Atoms.
RenderImagePreview
Renders a preview of an image with the specified parameters.
Request
POST /api/atoms/v1/images/render-preview[?attachment&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
attachment | query | If set to 'true', file will be provided as an attachment with unique filename supplied (default value is 'false'). |
||
tenantId | query | Tenant identifier |
||
body | body |
|
Render model with preview parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
401 | Unauthorized |
||
403 | Forbidden |
RenderImagePreviewFromFile
Renders a preview of an uploaded image with the specified parameters.
Request
POST /api/atoms/v1/images/render-preview/from-file[?attachment&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
attachment | query | If set to 'true', file will be provided as an attachment with unique filename supplied (default value is 'false'). |
||
tenantId | query | Tenant identifier |
||
sourceFile | formData | Source file. |
||
mockupOwnerId | formData | Mockup owner identifier. |
||
mockupId | formData | Mockup identifier. |
||
width | formData | Image preview width. |
||
height | formData | Image preview height. |
||
fileFormat | formData | Image preview file format. |
||
fitMode | formData | Image preview fit mode. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
401 | Unauthorized |
||
403 | Forbidden |
RenderImagePreviewFromFileToResource
Renders a preview of an uploaded image with the specified parameters and saves rendering result as resource.
Request
POST /api/atoms/v1/images/render-preview/from-file/to-resource[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
resourceOwnerId | formData | Preview resource owner identifier. |
||
resourceNamespace | formData | Preview resource namespace. |
||
resourceName | formData | Preview resource name. |
||
resourceSourceId | formData | Preview resource unique source identifier. |
||
resourceType | formData | Preview resource type. |
||
anonymousAccess | formData | Flag that indicates if a preview resource should be available for downloading for anonymous users. |
||
overwriteExistingResource | formData | Flag that indicates if an existing resource should be overwritten. |
||
sourceFile | formData | Source file. |
||
mockupOwnerId | formData | Mockup owner identifier. |
||
mockupId | formData | Mockup identifier. |
||
width | formData | Image preview width. |
||
height | formData | Image preview height. |
||
fileFormat | formData | Image preview file format. |
||
fitMode | formData | Image preview fit mode. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 |
|
Success |
|
409 |
|
Conflict |
|
401 | Unauthorized |
||
403 | Forbidden |
RenderImagePreviewFromUrl
Renders a preview of a web image with the specified parameters.
Request
POST /api/atoms/v1/images/render-preview/from-url[?attachment&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
attachment | query | If set to 'true', file will be provided as an attachment with unique filename supplied (default value is 'false'). |
||
tenantId | query | Tenant identifier |
||
body | body |
|
Render model with preview parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
401 | Unauthorized |
||
403 | Forbidden |
RenderImagePreviewFromUrlToResource
Renders a preview of a web image with the specified parameters and saves rendering result as resource.
Request
POST /api/atoms/v1/images/render-preview/from-url/to-resource[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Render model with preview parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 |
|
Success |
|
409 |
|
Conflict |
|
401 | Unauthorized |
||
403 | Forbidden |
RenderImagePreviewToResource
Renders a preview of an image with the specified parameters and saves rendering result as resource.
Request
POST /api/atoms/v1/images/render-preview/to-resource[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Render model with preview parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 |
|
Success |
|
409 |
|
Conflict |
|
401 | Unauthorized |
||
403 | Forbidden |
DesignAtomsMockups3d
These endpoints are used to manipulate 3D-Mockups via Design Atoms.
GetAttributes
Returns a 3D-Mockup attributes.
Request
GET /api/atoms/v1/mockups-3d/{id}/attributes[?ownerId&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | 3D-Mockup identifier. |
||
ownerId | query | Private mockup owner identifier. |
||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 |
|
Success |
|
404 |
|
Not Found |
|
422 |
|
Client Error |
|
401 | Unauthorized |
||
403 | Forbidden |
GetContentAsProtobuf
Returns a 3D-Mockup content as protobuf binary stream.
Request
GET /api/atoms/v1/mockups-3d/{id}/content/as-protobuf[?ownerId&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | 3D-Mockup identifier. |
||
ownerId | query | Private mockup owner identifier. |
||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
404 |
|
Not Found |
|
422 |
|
Client Error |
|
401 | Unauthorized |
||
403 | Forbidden |
GetGeometryFile
Returns a 3D-Mockup geometry as binary stream.
Request
GET /api/atoms/v1/mockups-3d/{id}/geometry/file[?ownerId&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | 3D-Mockup identifier. |
||
ownerId | query | Private mockup owner identifier. |
||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
404 |
|
Not Found |
|
422 |
|
Client Error |
|
401 | Unauthorized |
||
403 | Forbidden |
DesignAtomsService
These endpoints are used to manipulate Design Atoms models.
CreateDesign
Creates new design file with specified parameters and saves it in storage.
Request
POST /api/atoms/v1/designs[?privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
||
body | body |
|
Design creation parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
201 |
|
Created |
|
401 | Unauthorized |
||
403 | Forbidden |
ExtractBackground
Returns content of the background.
Request
GET /api/atoms/v1/designs/{id}/background[?surfaceIndex&privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | Design identifier. |
||
surfaceIndex | query | Surface index. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
404 |
|
Not Found |
|
422 |
|
Client Error |
|
401 | Unauthorized |
||
403 | Forbidden |
LoadProduct
Loads product (design model) from design file taken from storage.
Request
GET /api/atoms/v1/designs/{id}/model[?privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | Design identifier. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
SaveProduct
Saves product (design model) to design file and updates design in storage.
Request
PUT /api/atoms/v1/designs/{id}/model[?privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | Design identifier. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
||
body | body | Serialized product description. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
PatchProduct
Patches product (design model) in design file.
Design with specified identifier must exist at desired storage.
Request
PATCH /api/atoms/v1/designs/{id}/model[?privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | Design identifier. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
||
patchType | formData | Patch operation type. |
||
replaceImageItemFileInfo.itemName | formData | Item Name. |
||
replaceImageItemFileInfo.sourceFile | formData | Patch source file. |
||
replacePlaceholderItemContentInfo.placeholderItemName | formData | Item Name. |
||
replacePlaceholderItemContentInfo.newContentType | formData | New content type. |
||
replacePlaceholderItemContentInfo.sourceFile | formData | Patch source file. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
GetDesignParameters
Returns design parameters stored in product model.
Request
GET /api/atoms/v1/designs/{id}/parameters[?privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | Design identifier. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 |
|
Success |
|
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
LoadDataSchema
Loads data schema from design file taken from storage.
Request
GET /api/atoms/v1/designs/{id}/schema[?privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | Design identifier. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
404 |
|
Not Found |
|
409 |
|
Conflict |
|
401 | Unauthorized |
||
403 | Forbidden |
LoadToggleSet
Loads a toggle set from design file taken from storage.
Request
GET /api/atoms/v1/designs/{id}/toggle-set[?privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | Design identifier. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
404 |
|
Not Found |
|
409 |
|
Conflict |
|
401 | Unauthorized |
||
403 | Forbidden |
GetVariables
Gets variable items information for design file taken from storage.
Request
GET /api/atoms/v1/designs/{id}/variables[?privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | Design identifier. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 |
|
Success |
|
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
SetVariables
Sets variable items values for design file taken from storage.
Request
PUT /api/atoms/v1/designs/{id}/variables[?privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | Design identifier. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
||
body | body |
|
Design variable values. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
404 |
|
Not Found |
|
409 |
|
Conflict |
|
401 | Unauthorized |
||
403 | Forbidden |
LoadVdpData
Loads variable data printing information from design file taken from storage.
Request
GET /api/atoms/v1/designs/{id}/vdp-data[?privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | Design identifier. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 |
|
Success |
|
404 |
|
Not Found |
|
409 |
|
Conflict |
|
401 | Unauthorized |
||
403 | Forbidden |
SaveVdpData
Saves variable data printing information to design file and updates design in storage.
Design with specified identifier must exist at desired storage.
Request
PUT /api/atoms/v1/designs/{id}/vdp-data[?privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | Design identifier. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
||
body | body |
|
Serialized vdp data. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
DeleteVdpData
Deletes variable data printing information from design file and updates design in storage.
Design with specified identifier must exist at desired storage.
Request
DELETE /api/atoms/v1/designs/{id}/vdp-data[?privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | Design identifier. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
409 |
|
Conflict |
|
401 | Unauthorized |
||
403 | Forbidden |
LoadProductFromResource
Loads product (design model) from resource file taken from storage.
Request
GET /api/atoms/v1/designs/from-resource/{id}/model[?privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*id | path | Resource identifier. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
404 |
|
Not Found |
|
422 |
|
Client Error |
|
401 | Unauthorized |
||
403 | Forbidden |
ConvertColors
Converts colors.
Request
POST /api/atoms/v1/designs/model/convert-colors[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Convert colors operation parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
ExtractItemImage
Extracts product item image.
Request
POST /api/atoms/v1/designs/model/items/extract-image[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Extraction parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
401 | Unauthorized |
||
403 | Forbidden |
FlattenItems
Flatten items.
Request
POST /api/atoms/v1/designs/model/items/flatten[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body | array | Items to flatten. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
CreateItemFromFile
Creates product item from input image file.
Request
POST /api/atoms/v1/designs/model/items/from-file[?itemType&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
itemType | query | Desired item type. |
||
tenantId | query | Tenant identifier |
||
sourceFile | formData | Input files. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
BatchCreateItemsFromFile
Creates multiple product items from input image files.
Request
POST /api/atoms/v1/designs/model/items/from-file/batch-create[?itemType&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
itemType | query | Desired items type. |
||
tenantId | query | Tenant identifier |
||
sourceFiles | formData | List of input files. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
CreateItemFromStorage
Creates product item from image in storage.
Request
POST /api/atoms/v1/designs/model/items/from-storage[?itemType&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
itemType | query | Desired item type. |
||
tenantId | query | Tenant identifier |
||
body | body |
|
Operation parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
BatchCreateItemsFromStorage
Creates multiple product items from images in storage.
Request
POST /api/atoms/v1/designs/model/items/from-storage/batch-create[?itemType&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
itemType | query | Desired items type. |
||
tenantId | query | Tenant identifier |
||
body | body |
|
Create items operation parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
CreateItemFromUrl
Creates product item from remote web image provided by URL.
Request
POST /api/atoms/v1/designs/model/items/from-url[?itemType&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
itemType | query | Desired item type. |
||
tenantId | query | Tenant identifier |
||
body | body |
|
Operation parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
BatchCreateItemsFromUrl
Creates multiple product items from remote web images provided by URLs list.
Request
POST /api/atoms/v1/designs/model/items/from-url/batch-create[?itemType&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
itemType | query | Desired items type. |
||
tenantId | query | Tenant identifier |
||
body | body |
|
Operation parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
RenderProduct
Render product proof image with specified parameters.
Request
POST /api/atoms/v1/designs/model/render-proof[?attachment&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
attachment | query | If set to 'true', file will be provided as an attachment with unique filename supplied (default value is 'false'). |
||
tenantId | query | Tenant identifier |
||
body | body |
|
Preview parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
401 | Unauthorized |
||
403 | Forbidden |
RenderDesignPreview
Renders a design preview with the specified parameters.
Request
POST /api/atoms/v1/designs/render-preview[?attachment&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
attachment | query | If set to 'true', file will be provided as an attachment with unique filename supplied (default value is 'false'). |
||
tenantId | query | Tenant identifier |
||
body | body |
|
Render model with preview parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
401 | Unauthorized |
||
403 | Forbidden |
RenderDesignPreviewToResource
Renders a design preview with the specified parameters and saves rendering result as resource.
Request
POST /api/atoms/v1/designs/render-preview/to-resource[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Render model with preview parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 |
|
Success |
|
409 |
|
Conflict |
|
401 | Unauthorized |
||
403 | Forbidden |
RenderDesignProof
Renders a design proof with the specified parameters.
Request
POST /api/atoms/v1/designs/render-proof[?attachment&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
attachment | query | If set to 'true', file will be provided as an attachment with unique filename supplied (default value is 'false'). |
||
tenantId | query | Tenant identifier |
||
body | body |
|
Render model with proof parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
401 | Unauthorized |
||
403 | Forbidden |
RenderDesignProofToResource
Renders a design proof with the specified parameters and saves rendering result as resource.
Request
POST /api/atoms/v1/designs/render-proof/to-resource[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Render model with preview parameters. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 |
|
Success |
|
409 |
|
Conflict |
|
401 | Unauthorized |
||
403 | Forbidden |
CreateItem Deprecated
Creates product item.
Request
POST /api/atoms/v1/designs/model/items[?itemType&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
itemType | query | Desired item type. |
||
tenantId | query | Tenant identifier |
||
sourceType | formData | Source type. |
||
sourceId | formData | Source id, used if source type is 'ImageStorage' or 'PrivateImageStorage'. |
||
sourceOwnerId | formData | Source owner id, used if source type is 'PrivateImageStorage'. |
||
url | formData | Source URL, used if source type is 'Url'. |
||
sourceFile | formData | Source file, used if source type is 'File'. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
CreatePrivateDesignFromDesign Deprecated
Creates a private design from a public design.
Request
POST /api/atoms/v1/private-designs/from-design[?designId&privateDesignId&privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
designId | query | Public design identifier. |
||
privateDesignId | query | Private design identifier. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
201 | Created |
||
401 | Unauthorized |
||
403 | Forbidden |
CreatePrivateDesignFromResource Deprecated
Creates a private design from a public resource.
Request
POST /api/atoms/v1/private-designs/from-resource[?resourceId&privateDesignId&privateStorageOwner&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
resourceId | query | Resource identifier. |
||
privateDesignId | query | Private design identifier. |
||
privateStorageOwner | query | Private storage owner identifier. |
||
tenantId | query | 0 | Tenant identifier. |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
201 | Created |
||
401 | Unauthorized |
||
403 | Forbidden |
DesignAtomsViewer
These endpoints are used to manipulate Design Atoms models
CssFonts
Request
POST /api/atoms/v1/ccviewer/cssfonts[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
401 | Unauthorized |
||
403 | Forbidden |
Fonts
Request
GET /api/atoms/v1/ccviewer/fonts/{psName}[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
*psName | path | |||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
GetColorPreview
Request
POST /api/atoms/v1/ccviewer/GetColorPreview[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
GetColorPreviews
Request
POST /api/atoms/v1/ccviewer/GetColorPreviews[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
GetCssFont
Request
GET /api/atoms/v1/ccviewer/GetCssFont[?fontKey&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
fontKey | query | |||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
GetFallbackFonts
Request
GET /api/atoms/v1/ccviewer/GetFallbackFonts[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
GetImageSize
Request
POST /api/atoms/v1/ccviewer/GetImageSize[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 |
|
Success |
|
401 | Unauthorized |
||
403 | Forbidden |
GetShapeBounds
Request
POST /api/atoms/v1/ccviewer/GetShapeBounds[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 |
|
Success |
|
401 | Unauthorized |
||
403 | Forbidden |
GetWatermarkItems
Request
POST /api/atoms/v1/ccviewer/GetWatermarkItems[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
Img
Request
GET /api/atoms/v1/ccviewer/img[?f&w&h&cmyk&rgb&grayscale&target&sq&effect&kp&color&obm&oo&alphaMask&page&colorizeColor&rw&rh&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
f | query | |||
w | query | |||
h | query | |||
cmyk | query | |||
rgb | query | |||
grayscale | query | |||
target | query | |||
sq | query | |||
effect | query | |||
kp | query | |||
color | query | |||
obm | query | |||
oo | query | |||
alphaMask | query | |||
page | query | |||
colorizeColor | query | |||
rw | query | |||
rh | query | |||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
304 | Not Modified |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
GetLicense
Request
GET /api/atoms/v1/ccviewer/license[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
Pth
Request
GET /api/atoms/v1/ccviewer/pth[?f&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
f | query | |||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
304 | Not Modified |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
Resource
Request
GET /api/atoms/v1/ccviewer/resource[?image&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
image | query | |||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
Svg
Request
GET /api/atoms/v1/ccviewer/svg[?f&w&h&cmyk&rgb&grayscale&target&sq&effect&kp&color&obm&oo&alphaMask&page&colorizeColor&rw&rh&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
f | query | |||
w | query | |||
h | query | |||
cmyk | query | |||
rgb | query | |||
grayscale | query | |||
target | query | |||
sq | query | |||
effect | query | |||
kp | query | |||
color | query | |||
obm | query | |||
oo | query | |||
alphaMask | query | |||
page | query | |||
colorizeColor | query | |||
rw | query | |||
rh | query | |||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
304 | Not Modified |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
Txt
Request
GET /api/atoms/v1/ccviewer/txt[?f&tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
f | query | |||
tenantId | query | Tenant identifier |
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | string | Success |
|
304 | Not Modified |
||
404 |
|
Not Found |
|
401 | Unauthorized |
||
403 | Forbidden |
UpdateArchedTextItemHandler
Request
POST /api/atoms/v1/ccviewer/UpdateArchedTextItemHandler[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateAutoScaledTextItemHandler
Request
POST /api/atoms/v1/ccviewer/UpdateAutoScaledTextItemHandler[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateBarcodeItemHandler
Request
POST /api/atoms/v1/ccviewer/UpdateBarcodeItemHandler[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateBoundedTextItemHandler
Request
POST /api/atoms/v1/ccviewer/UpdateBoundedTextItemHandler[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateByColorData
Request
POST /api/atoms/v1/ccviewer/UpdateByColorData[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateByMultiCallRequest
Request
POST /api/atoms/v1/ccviewer/UpdateByMultiCallRequest[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateCurvedTextItemHandler
Request
POST /api/atoms/v1/ccviewer/UpdateCurvedTextItemHandler[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateImageItemHandler
Request
POST /api/atoms/v1/ccviewer/UpdateImageItemHandler[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdatePathBoundedTextItemHandler
Request
POST /api/atoms/v1/ccviewer/UpdatePathBoundedTextItemHandler[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdatePlainTextItemHandler
Request
POST /api/atoms/v1/ccviewer/UpdatePlainTextItemHandler[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
UpdateShapeItemHandler
Request
POST /api/atoms/v1/ccviewer/UpdateShapeItemHandler[?tenantId]
Parameters
Name | In | Type | Default | Notes |
---|---|---|---|---|
tenantId | query | Tenant identifier |
||
body | body |
|
Responses
Status Code | Type | Description | Samples |
---|---|---|---|
200 | Success |
||
401 | Unauthorized |
||
403 | Forbidden |
Definitions
BuildInfoModel
Information about a service.
Name | Type | Notes |
---|---|---|
version | string | Version number. |
buildDate | string | Build date (UTC). |
configuration | string | Build configuration (Debug | Release). |
appName | string | Service name. |
designAtomsVersion | string | Aurigma.DesignAtoms version. |
designAtomsModelVersion | string | Aurigma.DesignAtoms.Model version. |
FontsMethodData
Name | Type | Notes |
---|---|---|
requestedFontsByPsName | array | |
advancedMode | boolean | |
baseUrl | string |
ProblemDetails
Name | Type | Notes |
---|---|---|
type | string | |
title | string | |
status | integer (int32) | |
detail | string | |
instance | string |
GetColorPreviewRequest
Name | Type | Notes |
---|---|---|
colorData | ||
colorSettings |
GetColorPreviewsRequest
Name | Type | Notes |
---|---|---|
colorData | ||
colorSettings |
GetImageSizeRequest
Name | Type | Notes |
---|---|---|
imageId | string | |
pageIndex | integer (int32) |
NullAbleSize
Name | Type | Notes |
---|---|---|
width | integer (int32) | |
height | integer (int32) |
GetShapeBoundsRequest
Name | Type | Notes |
---|---|---|
path | string |
RectangleF
Name | Type | Notes |
---|---|---|
location |
|
|
size | string | |
x | number (float) | |
y | number (float) | |
width | number (float) | |
height | number (float) | |
left | number (float) | |
top | number (float) | |
right | number (float) | |
bottom | number (float) | |
isEmpty | boolean |
PointF
Name | Type | Notes |
---|---|---|
isEmpty | boolean | |
x | number (float) | |
y | number (float) |
UpdateHandlerRequest
Name | Type | Notes |
---|---|---|
canvasData | string | |
itemHandlerData | string | |
itemData | ||
colorSettings |
UpdateColorsRequest
Name | Type | Notes |
---|---|---|
canvasData | string | |
colorData | string |
MultiCallRequest
Name | Type | Notes |
---|---|---|
items |
|
MultiCallRequestItem
Name | Type | Notes |
---|---|---|
canvasData | string | |
itemHandlersData | string | |
colorData | string | |
actualSize | boolean | |
preserveAspectRatio | boolean | |
url | string | |
imageId | string | |
pageIndex | integer (int32) | |
methodName | string | |
itemData | ||
colorSettings |
UpdateImageHandlerRequest
Name | Type | Notes |
---|---|---|
actualSize | boolean | |
preserveAspectRatio | boolean | |
url | string | |
canvasData | string | |
itemHandlerData | string | |
itemData | ||
colorSettings |
RenderImagePreviewModel
Image preview rendering parameters.
Name | Type | Notes |
---|---|---|
imageUrl | string | External image URL. |
imageId | string | Storage image identifier. |
ownerId | string | Storage image owner identifier. |
mockupOwnerId | string | Mockup owner identifier. |
mockupId | string | Mockup identifier. |
renderingConfig | Image preview configuration. |
ResourceInfoDto
Name | Type | Notes |
---|---|---|
id | string | |
ownerId | string | |
name | string | |
namespace | string | |
private | boolean | |
url | string |
RenderImagePreviewFromUrlModel
Web image preview rendering parameters.
Name | Type | Notes |
---|---|---|
imageUrl | string | Web image URL. |
mockupOwnerId | string | Mockup owner identifier. |
mockupId | string | Mockup identifier. |
renderingConfig | Image preview configuration. |
RenderImagePreviewFromUrlToResourceModel
Image preview rendering parameters. Result will be saved as resource with parameters set as Aurigma.DesignAtomsApi.WebApi.Models.Image.RenderImagePreviewFromUrlToResourceModel.PreviewResourceParams.
Name | Type | Notes |
---|---|---|
previewResourceParams | Parameters of resource that should be created for a preview rendering result. |
|
overwriteExistingResource | boolean | Flag that indicates if an existing resource should be overwritten. |
imageUrl | string | Web image URL. |
mockupOwnerId | string | Mockup owner identifier. |
mockupId | string | Mockup identifier. |
renderingConfig | Image preview configuration. |
RenderImagePreviewToResourceModel
Image preview rendering parameters. Result will be saved as resource with parameters set as Aurigma.DesignAtomsApi.WebApi.Models.Image.RenderImagePreviewToResourceModel.PreviewResourceParams.
Name | Type | Notes |
---|---|---|
previewResourceParams | Parameters of resource that should be created for a preview rendering result. |
|
overwriteExistingResource | boolean | Flag that indicates if an existing resource should be overwritten. |
imageUrl | string | External image URL. |
imageId | string | Storage image identifier. |
ownerId | string | Storage image owner identifier. |
mockupOwnerId | string | Mockup owner identifier. |
mockupId | string | Mockup identifier. |
renderingConfig | Image preview configuration. |
Mockup3dAttributesDto
Name | Type | Notes |
---|---|---|
data | object |
CreateDesignModel
Design creation parameters.
Name | Type | Notes |
---|---|---|
product | Serialized product description. |
|
dataSchema | string | Serialized product data schema (base64 file stream). |
name | string | Design name. |
path | string | Design location (folder path). |
DesignInfo
Name | Type | Notes |
---|---|---|
id | string | |
ownerId | string | |
name | string | |
private | boolean |
MissingDesignElementDto
Name | Type | Notes |
---|---|---|
description | string | Problem description. |
missingElementType |
|
Missing element type. |
DesignElementType
Missing element type.
Enum Values
Product Design Surface Container PrintArea Item
UnprocessableDesignElementDto
Name | Type | Notes |
---|---|---|
description | string | Problem description. |
missingElementType |
|
Missing element type. |
DesignParameters
Specific design parameters stored in product model.
Name | Type | Notes |
---|---|---|
measureUnit |
|
Design measure unit description. |
designAtomsVersion | string | Version of DesignAtoms library that used to save design file. |
MeasureUnitInfo
Design measure unit description.
Name | Type | Notes |
---|---|---|
name | string | |
shortName | string | |
ratio | number (float) |
VariablesModel
Variables information.
Name | Type | Notes |
---|---|---|
items |
|
List of variables. |
VariableInfo
List of variables.
Name | Type | Notes |
---|---|---|
name | string | Variable name. |
value | string | Variable value. |
type | string | Variable type. |
VdpDataModel
Variable data printing information.
Name | Type | Notes |
---|---|---|
vdpDataSet | Serialized vdp dataset. |
|
vdpItemsData | Serialized vdp items data. |
ConvertColorsModel
Convert colors operation parameters.
Name | Type | Notes |
---|---|---|
colors | array | Serialized color description. |
sourceColorProfile | string | Source color profile description. |
destinationColorProfile | string | Destination color profile description. |
targetDeviceColorProfile | string | Target color profile description. |
ExtractItemImageModel
Item extraction operation parameters.
Name | Type | Notes |
---|---|---|
item | Serialized item description. |
CreateItemFromStorageModel
Create item from storage source operation parameters.
Name | Type | Notes |
---|---|---|
sourceOwnerId | string | Source image asset owner identifier. If value is set, all images should belong to a specified user. |
sourceId | string | Source image asset identifier. |
BatchCreateItemsFromStorageModel
Batch create items from storage source operation parameters.
Name | Type | Notes |
---|---|---|
sourceOwnerId | string | Source image assets owner identifier. If value is set, all images should belong to a specified user. |
sourceIds | array | Source image asset identifiers. |
CreateItemFromUrlModel
Create item from web source operation parameters.
Name | Type | Notes |
---|---|---|
url | string | Source URL. |
BatchCreateItemsFromUrlModel
Batch create items from web source operation parameters.
Name | Type | Notes |
---|---|---|
urls | array | Source URLs. |
RenderProductModel
Render product parameters.
Name | Type | Notes |
---|---|---|
product | Serialized product description. |
|
renderingConfig | Proof Image rendering config. |
RenderDesignPreviewModel
Name | Type | Notes |
---|---|---|
designId | string | Design identifier. Used to get design file from public or private storage. |
mockupId | string | Mockup identifier. Used to get mockup file from public storage. |
ownerId | string | Identifier of the design owner. |
mockupOwnerId | string | Identifier of the mockup owner. |
renderingConfig | Rendering configuration for getting a preview of design. |
|
variableData |
|
Variable (user) data for design variable fields in the preview image. |
RenderDesignPreviewToResourceModel
Name | Type | Notes |
---|---|---|
previewResourceParams | Parameters of resource that should be created for a preview rendering result. |
|
overwriteExistingResource | boolean | Flag that indicates if an existing resource should be overwritten. |
designId | string | Design identifier. Used to get design file from public or private storage. |
mockupId | string | Mockup identifier. Used to get mockup file from public storage. |
ownerId | string | Identifier of the design owner. |
mockupOwnerId | string | Identifier of the mockup owner. |
renderingConfig | Rendering configuration for getting a preview of design. |
|
variableData |
|
Variable (user) data for design variable fields in the preview image. |
RenderDesignProofModel
Name | Type | Notes |
---|---|---|
designId | string | Design identifier. Used to get design file from public or private storage. |
ownerId | string | Identifier of the design owner. |
renderingConfig | Rendering configuration for getting a proof image of design. |
|
variableData |
|
Variable (user) data for design variable fields in the proof image. |
RenderDesignProofToResourceModel
Name | Type | Notes |
---|---|---|
proofResourceParams | Parameters of resource that should be created for a preview rendering result. |
|
overwriteExistingResource | boolean | Flag that indicates if an existing resource should be overwritten. |
designId | string | Design identifier. Used to get design file from public or private storage. |
ownerId | string | Identifier of the design owner. |
renderingConfig | Rendering configuration for getting a proof image of design. |
|
variableData |
|
Variable (user) data for design variable fields in the proof image. |