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. Textures

Texture Categories

Retrieve texture categories endpoints

GET /textures-categories/list

Endpoint: Retrieve All Texture Categories

HTTP Method: GET

URL: /open-api/v1/textures-categories/list

Description: This endpoint retrieves a list of all texture categories available in the database without applying pagination filters. It returns a detailed list ensuring all categories are accessible in a single response.

Response Format:

  • Status Code: 200 OK

  • Content-Type: application/json

Response Example:

[
    {
        "id": "1",
        "name": "Wood"
    },
    {
        "id": "2",
        "name": "Metal"
    },
    {
        "id": "3",
        "name": "Stone"
    }
    // ... more categories
]

Notes:

  • Ensure proper authorization headers are included if necessary.

  • The response will include all categories, so handle large datasets appropriately in your application.

GET /textures-categories/{id}

Get Texture Category by ID - GET Endpoint

Endpoint:

GET open-api/v1/textures-categories/{id}

Description:

Retrieve detailed information about a specific texture category using its unique ID.

Authorization:

Ensure appropriate authorization headers are included in the request.

Parameters:

  • id (path parameter) - The unique identifier of the texture category.

Response:

Returns a JSON object containing detailed information about the texture category, such as its name, description, and any related metadata.

Example Response:

{
    "id": "2",
    "name": "Metal",
    "description": "A category for all metal-based textures."
}

Notes:

  • Handle any potential errors such as 404 Not Found for invalid IDs.

  • Consider rate limits and implement retry logic as appropriate.

GET /textures-categories

Get List of Texture Categories

The Get List of Texture Categories endpoint retrieves a complete list of available texture categories. Each category includes essential details such as the category's ID, name, and description.

Endpoint

GET /open-api/v1/textures-categories

Example Request

GET /open-api/v1/texture-categories HTTP/1.1
Host: api.simplio3d.com
Authorization: Bearer YOUR_ACCESS_TOKEN

Example Response

[
    {
        "id": "1",
        "name": "Wood",
        "description": "A category for all wood-based textures."
    },
    {
        "id": "2",
        "name": "Metal",
        "description": "A category for all metal-based textures."
    }
]

Notes

  • Ensure a valid access token is provided in the request header.

  • Handle potential errors, such as 401 Unauthorized if the token is invalid or expired.

  • Implement retry logic to handle rate limit errors if encountered.

PreviousTexturesNextOrders

Last updated 21 days ago

Was this helpful?

Retrieve all texture categories without pagination

get

Get all texture categories without pagination.

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:
Responses
200
Successful response
application/json
401
Unauthorized
500
Internal server error
get
GET /api/open-api/v1/textures-categories/list HTTP/1.1
Host: app.simplio3d.com
Authorization: Bearer JWT
Accept: */*
[
  {
    "id": 1,
    "title": "Wood Textures",
    "description": "Collection of wood textures",
    "created_at": "2024-02-21T12:34:56Z",
    "updated_at": "2024-02-21T12:34:56Z",
    "created_by": "John Doe"
  }
]

Get texture category by ID

get

Get a specific texture category by ID.

Authorizations
Path parameters
idinteger · int64Required

ID of the texture category

Responses
200
Successful response
application/json
401
Unauthorized
404
Texture category not found
get
GET /api/open-api/v1/textures-categories/{id} HTTP/1.1
Host: app.simplio3d.com
Authorization: Bearer JWT
Accept: */*
{
  "id": 1,
  "title": "Wood Textures",
  "description": "Collection of wood textures",
  "created_at": "2024-02-21T12:34:56Z",
  "updated_at": "2024-02-21T12:34:56Z",
  "created_by": "John Doe"
}

Get list of textures categories

get

Get all textures categories.

Authorizations
Query parameters
per_pageintegerOptional

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

Example: 25
pageintegerOptional

Number of page

Example: 2
order_bystringOptional

Column to sort by

Example: created_at
orderstringOptional

Sort order (asc/desc)

Example: desc
Responses
200
Successful response
401
Unauthorized
500
Internal Server Error
get
GET /api/open-api/v1/textures-categories HTTP/1.1
Host: app.simplio3d.com
Authorization: Bearer JWT
Accept: */*

No content

  • GET /textures-categories/list
  • GETRetrieve all texture categories without pagination
  • GET /textures-categories/{id}
  • GETGet texture category by ID
  • GET /textures-categories
  • GETGet list of textures categories