Third-party platforms call the Query-Products-of-Specified-Fixture interface (
/api/Fixture/getFixtureData) to query the open platform for the details of a specific fixture under the designated printer and its associated products. The platform synchronously returns the fixture's basic information and the layout parameters of each product inside the fixture — used to precisely obtain fixture configuration and product print coordinates, dimensions, and row/column counts required for merged printing.
Note: In the source text, the usage description ends with two periods ("data。。"); preserved verbatim.
Interface Information
- Endpoint:
https://www.colorpark.cn/api/Fixture/getFixtureData - Method: POST
Request Parameters
| Parameter | Example Value | Data Type | Required | Description |
|---|---|---|---|---|
printer_id |
500001 | string | Yes | Unique device ID assigned to the printer; each printer is assigned a distinct number. |
once |
8305 | string | Yes | Random value used when generating the signature (nonce). |
time |
1646790335 | string | Yes | Timestamp used when generating the signature. |
sign |
9ce3ce7a3fccaf3d7715bd7e9bb1dc1c | string | Yes | Generated signature. For the generation method, please refer to the Bottom-Level Methods [Basic Support] → Generate Signature section. |
fixture_id |
56 | string | No | Fixture ID, used to query all products under the fixture by fixture number. |
unique |
RefrigeratorMagnet | string | No | Product identifier within the fixture. |
Response Result
| Field | Data Type | Example Value | Description |
|---|---|---|---|
code |
string | 0 | Result status code. 0 on success, 1 on failure. |
msg |
string | Submission successful | Result description, e.g., Submission successful. |
data.fixture_id |
string | 18 | Fixture number. |
data.fixture_name |
string | Standard | Fixture name, for conveniently switching to the specified fixture in the client software. |
data.fixture_width |
string | 185 | Fixture width. |
data.fixture_height |
string | 140 | Fixture height. |
data.fixture_image |
string | https://rfccrm.oss-cn-shenzhen.aliyuncs.com/colorcloud/ai-template/c278906cf2f0f97fc67b43de71bdee9b91634aa9.png | Fixture cover image. |
data.fixture_goods |
array | [{"unique":"61zfxpt","name":"Square Jigsaw Puzzle",...}, ...] |
Fixture product list information. |
data.fixture_goods[].unique |
string | 61hzj | Unique identifier of a product within the fixture. |
data.fixture_goods[].name |
string | Badge | Fixture product name. |
data.fixture_goods[].width |
string | 54.6 | Fixture product print width (mm). |
data.fixture_goods[].height |
string | 54.6 | Fixture product print height (mm). |
data.fixture_goods[].row_num |
string | 1 | Number of products per row. |
data.fixture_goods[].column_num |
string | 1 | Number of products per column. |
data.fixture_goods[].spacing_left |
string | 0 | Left spacing (mm). |
data.fixture_goods[].spacing_top |
string | 0 | Top spacing (mm). |
data.fixture_goods[].origin_x |
string | 123.00 | Bottom-right print start point X (mm). |
data.fixture_goods[].origin_y |
string | 60 | Bottom-right print start point Y (mm). |
Note: In the source
fixture_goodsexample there is a likely typo — a stray key name"61cfxbxt":appears before the second array item, making the JSON structure invalid; preserved verbatim.
If a device encounters an unsolvable problem during commissioning, contact the cloud-printing lead to troubleshoot and find a solution. Contact details: Phone: 137-5177-4454 (WeChat same number) Email: info@ColorPark.cn