Query Fixtures of a Specified Device

Last updated：2026-10-13 13:48:35

By calling the Query-Fixtures-of-Specified-Device interface (/api/Fixture/getFixtureData), the open platform is queried for all available fixtures under the designated printer and their associated product data. The platform synchronously returns the fixture ID, name, width/height, status, cover image, and the layout parameters of each product within the fixture (unique identifier, dimensions, row/column count, spacing, origin coordinates, etc.) — used for front-end fixture selection, preloading merged-printing parameters, and multi-fixture layout calculation.

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 15 string No Fixture ID, used to retrieve data for a specific fixture.

Response Result (Example)

{
    "code": 0,
    "msg": "Retrieved successfully",
    "data": [
        {
            "fixture_id": 180,
            "fixture_name": "Standard Golf 25mm",
            "fixture_width": "185.0",
            "fixture_height": "140.0",
            "fixture_status": 1,
            "fixture_status_text": "Enabled",
            "fixture_image": "https://xxx.xxx.xxx/tupian.jpg",
            "fixture_goods": {
                "GOLF25": {
                    "unique": "GOLF25",
                    "name": "Standard Golf 25mm",
                    "width": "25.00",
                    "height": "25.00",
                    "row_num": 1,
                    "column_num": 1,
                    "spacing_left": "0.00",
                    "spacing_top": "0.00",
                    "origin_x": "0.00",
                    "origin_y": "0.00"
                }
            }
        },
        {
            "fixture_id": 179,
            "fixture_name": "Standard 5-in-1",
            "fixture_width": "185.0",
            "fixture_height": "140.0",
            "fixture_status": 1,
            "fixture_status_text": "Enabled",
            "fixture_image": "https://xxx.xxx.xxx/tupian.jpg",
            "fixture_goods": {
                "RefrigeratorMagnet": {
                    "unique": "RefrigeratorMagnet",
                    "name": "Standard Template - Fridge Magnet",
                    "width": "57.10",
                    "height": "74.50",
                    "row_num": 1,
                    "column_num": 1,
                    "spacing_left": "0.00",
                    "spacing_top": "0.00",
                    "origin_x": "124.50",
                    "origin_y": "56.90"
                },
                "Coin": {
                    "unique": "Coin",
                    "name": "Standard Template - Commemorative Coin",
                    "width": "50.10",
                    "height": "50.10",
                    "row_num": 1,
                    "column_num": 1,
                    "spacing_left": "0.00",
                    "spacing_top": "0.00",
                    "origin_x": "69.90",
                    "origin_y": "79.90"
                },
                "Circularbadge2": {
                    "unique": "Circularbadge2",
                    "name": "Standard Template - Round Badge",
                    "width": "58.80",
                    "height": "58.80",
                    "row_num": 1,
                    "column_num": 1,
                    "spacing_left": "0.00",
                    "spacing_top": "0.00",
                    "origin_x": "65.90",
                    "origin_y": "4.90"
                },
                "Squarejigsawpuzzle": {
                    "unique": "Squarejigsawpuzzle",
                    "name": "Standard Template - Square Jigsaw Puzzle",
                    "width": "55.10",
                    "height": "55.60",
                    "row_num": 1,
                    "column_num": 1,
                    "spacing_left": "0.00",
                    "spacing_top": "0.00",
                    "origin_x": "5.00",
                    "origin_y": "10.00"
                },
                "Circularjigsawpuzzle": {
                    "unique": "Circularjigsawpuzzle",
                    "name": "Standard Template - Round Jigsaw Puzzle",
                    "width": "59.70",
                    "height": "59.70",
                    "row_num": 1,
                    "column_num": 1,
                    "spacing_left": "0.00",
                    "spacing_top": "0.00",
                    "origin_x": "6.20",
                    "origin_y": "75.20"
                }
            }
        }
    ]
}

data fixture fields

Field Description
fixture_id Fixture ID.
fixture_name Fixture name.
fixture_width / fixture_height Fixture width / height (mm).
fixture_status Fixture status (1 Enabled in example).
fixture_status_text Fixture status name (e.g., Enabled).
fixture_image Fixture cover image URL.
fixture_goods Associated products keyed by unique identifier.

fixture_goods product layout fields

Field Description
unique Product unique identifier (used as the key).
name Product name.
width / height Product width / height (mm).
row_num Number of products per row.
column_num Number of products per column.
spacing_left Left spacing (mm).
spacing_top Top spacing (mm).
origin_x / origin_y Bottom-right print start point X / Y (mm).

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

Deep hardware–software integrated UV cloud-printing service provider ® Ruifengcai