Simplio3D
HomeHelp Center
  • INTRODUCTION
  • GETTING STARTED
    • Create an account
    • Prepare 3D models
  • LEARNING THE APP
    • Dashboard
    • My Account
    • Products
      • New Product
      • Select Layout
      • Add 3D Models
        • 3D Model versions
      • Create Options
        • Default
        • Sections
        • Dropdown
        • Material
        • Checkbox
        • Toggle
        • Thumbnails
        • Arrows
        • Upload
        • Text
        • Numeral
          • Sizing: Keep the proportions
        • Restrictions
          • 'Has one or more variants selected from' type of restriction
          • 'The variant value is between min and max' type of restriction
      • Pricing
        • Pricing formula
        • Variables
        • Add price
      • Add form
        • Add Field
        • Email Settings
          • Gmail
          • Sendgrid
      • Share
      • Product Viewer
    • Materials
      • New Materials
      • Textures
      • SVG
      • Categories
    • 3D Assets
      • Edit 3D Assets
      • Categories
      • File too large
    • Orders
  • Integrations
    • WooCommerce
    • Shopify
    • API Documentation
  • API Reference
    • Partner API
      • Managing Orders
    • Open API
      • Getting Started
      • User Authentication
      • 3D Assets
      • Configurators
      • Contact Form
        • Form Fields
        • Forms
      • Options
        • Options
        • Option Variations
        • Option Restrictions
      • Price Groups
      • Share
      • Materials
        • Materials
        • Material Categories
      • Textures
        • Textures
        • Texture Categories
      • Orders
    • Web SDK
  • Other
    • Change Log
Powered by GitBook
On this page

Was this helpful?

  1. API Reference
  2. Open API
  3. Options

Options

Managing Configurator Options

GET /configurator-options/types/list

Retrieve Available Configurator Option Types

Endpoint

GET /open-api/v1/configurator-options/types/list

Description

This endpoint retrieves the list of available configurator option types supported by Simplio3D.

Request Headers

  • Authorization: Bearer token for authentication

Response

  • 200 OK: Returns a JSON object containing an array of available option types.

  • 400 Bad Request: Invalid request parameters.

  • 401 Unauthorized: Invalid or missing authentication token.

Example Response

{
  "optionTypes": [
    "color",
    "size",
    "material",
    "custom-text"
  ]
}

Notes

  • Ensure you have valid authentication to access this endpoint.

  • Utilize the retrieved option types to understand and configure products efficiently within Simplio3D.

  • Ensure you have the necessary authorization credentials (e.g., Bearer Token) to access this endpoint which is taken from the 'Share' tab encryption token found at the bottom of the page.

GET /configurator-option/{id}

Retrieve details of a specific configurator option using its ID.

GET /configurator-option/{id}

Request

  • Endpoint: /configurator-option/{id}

  • Method: GET

  • Authentication: Required

Parameters

  • id (string): The unique identifier of the configurator option.

Response

A successful request returns a JSON object with details of the configurator option, including:

  • id (string): The unique identifier of the option.

  • name (string): The name of the option.

  • description (string, optional): A description of the option.

  • type (string): The type of option, e.g., "color", "size".

  • values (array): The possible values for this option.

Example Request

GET /configurator-option/12345 HTTP/1.1
Authorization: Bearer YOUR_ACCESS_TOKEN
Host: api.simplio3d.com

Example Response

{
  "id": "12345",
  "name": "Color",
  "description": "Select the color for the product",
  "type": "color",
  "values": ["red", "green", "blue"]
}

Notes

  • Ensure proper handling of the authentication token in your API calls.

  • Use this endpoint to look up and validate option specifications for product configurators.

  • Ensure you have the necessary authorization credentials (e.g., Bearer Token) to access this endpoint which is taken from the 'Share' tab encryption token found at the bottom of the page.

GET /configurator-options

Fetch All Configurator Options

To retrieve all configurator options, use the GET /configurator-options endpoint. This endpoint returns a list of options available for product configuration.

Request

  • Method: GET

  • Endpoint: /configurator-options

  • Headers:

    • Authorization: Bearer <your_auth_token>

    Response

    A successful response will return a JSON object with details such as option id, name, description, type, and values.

Example Response

[
  {
    "id": "12345",
    "name": "Color",
    "description": "Select the color for the product",
    "type": "color",
    "values": ["red", "green", "blue"]
  },
  {
    "id": "67890",
    "name": "Size",
    "description": "Choose the size for the product",
    "type": "dropdown",
    "values": ["small", "medium", "large"]
  }
]

Notes

  • Ensure that the authentication token is included in the request header to access the endpoint successfully.

  • Use this data to validate and check available options for product configurators efficiently.

  • Ensure you have the necessary authorization credentials (e.g., Bearer Token) to access this endpoint which is taken from the 'Share' tab encryption token found at the bottom of the page.

GET /configurator-options-variations

Retrieve a List of Configurator Option Variations

To retrieve a list of configurator option variations, you will need to make a GET request to the Simplio3D API endpoint designed for this purpose. Below is a brief explanation of how to interact with this endpoint:

Endpoint:

GET /api/configurator-options-variations

Headers:

  • Authorization: Bearer YOUR_AUTH_TOKEN

Response Format:

The endpoint responds with a JSON array where each element contains details about a specific configurator option. Example structure of each item in the array:

  • id: Unique identifier for the option.

  • name: Name of the option.

  • description: Brief description of the option.

  • type: Type of input field (e.g., "color", "dropdown").

  • values: An array of possible values.

Ensure to replace YOUR_AUTH_TOKEN with your actual authentication token and verify that your request headers are correctly set for successful interaction with the API.

NOTE: Ensure you have the necessary authorization credentials (e.g., Bearer Token) to access this endpoint which is taken from the 'Share' tab encryption token found at the bottom of the page.

PreviousOptionsNextOption Variations

Last updated 22 days ago

Was this helpful?

Retrieve available configurator option types

get

Get a list of available configurator option types.

Authorizations
Responses
200
List of configurator option types
application/json
401
Unauthorized request
500
Internal server error
get
GET /api/open-api/v1/configurator-options/types/list HTTP/1.1
Host: app.simplio3d.com
Authorization: Bearer JWT
Accept: */*
{
  "data": [
    {
      "default": "Default",
      "checkbox": "Checkbox",
      "material": "Material",
      "numeral": "Numeral",
      "radio": "Toggle",
      "section": "Section",
      "select": "Dropdown",
      "select_thumb": "Thumbnails",
      "text": "Text",
      "upload": "Upload",
      "arrows": "Arrows"
    }
  ]
}

Get configurator option by ID

get

Get a specific configurator option by ID.

Authorizations
Path parameters
idinteger · int64Required

ID of the configurator option

Responses
200
Successful response
application/json
401
Unauthorized
404
Configurator option not found
500
Server error
get
GET /api/open-api/v1/configurator-options/{id} HTTP/1.1
Host: app.simplio3d.com
Authorization: Bearer JWT
Accept: */*
{
  "id": 1,
  "configurator_id": 10,
  "title": "Color Selection",
  "option_type": "dropdown",
  "settings": "{'min':1,'max':5}",
  "parameter_list": "['red', 'blue', 'green']",
  "order": 2,
  "created_at": "2024-02-21T10:00:00Z",
  "updated_at": "2024-02-22T12:00:00Z",
  "created_by": "John Doe"
}

Fetch all configurator options

get

Get a list of configurator 3D assets models.

Authorizations
Query parameters
order_bystringOptional

Column to order results by (e.g., 'created_at')

Example: created_at
orderstring · enumOptional

Sorting order (asc or desc)

Example: descPossible values:
per_pageintegerOptional

Number of records per page (-1 for all records)

Example: 25
pageintegerOptional

Number of page

Example: 2
Responses
200
List of configurator options
application/json
400
Invalid request parameters
401
Unauthorized request
403
Forbidden - user does not have permission
500
Internal server error
get
GET /api/open-api/v1/configurator-options HTTP/1.1
Host: app.simplio3d.com
Authorization: Bearer JWT
Accept: */*
{
  "data": [
    {
      "id": 1,
      "configurator_id": 10,
      "title": "Color Selection",
      "option_type": "dropdown",
      "settings": "{'min':1,'max':5}",
      "parameter_list": "['red', 'blue', 'green']",
      "order": 2,
      "created_at": "2024-02-21T10:00:00Z",
      "updated_at": "2024-02-22T12:00:00Z",
      "created_by": "John Doe"
    }
  ]
}

Retrieve a list of configurator option variations

get

Get a list of configurator option variations.

Authorizations
Query parameters
configurator_option_idintegerOptional

The ID of the configurator option for which to retrieve variations.

Example: 45
Responses
200
List of configurator option variations
application/json
400
Invalid request parameters
401
Unauthorized request
403
Forbidden - user does not have permission
500
Internal server error
get
GET /api/open-api/v1/configurator-option-variations HTTP/1.1
Host: app.simplio3d.com
Authorization: Bearer JWT
Accept: */*
{
  "data": [
    {
      "id": 1,
      "configurator_id": 127,
      "configurator_option_id": 45,
      "configurator_option_value": "Red",
      "title": "Red Glossy",
      "name": "Glossy Finish",
      "settings": "{}",
      "created_at": "2024-02-25T12:00:00Z",
      "updated_at": "2024-02-25T12:30:00Z"
    }
  ]
}
  • GET /configurator-options/types/list
  • GETRetrieve available configurator option types
  • GET /configurator-option/{id}
  • GETGet configurator option by ID
  • GET /configurator-options
  • GETFetch all configurator options
  • GET /configurator-options-variations
  • GETRetrieve a list of configurator option variations