Textures

Fetch texture(s)

GET /textures

Fetch All Textures - GET Endpoint

The Fetch All Textures endpoint of the Simplio3D API provides a list of all available textures. This endpoint is useful for retrieving texture data that can be applied within the Simplio3D environment.

URL

GET /open-api/v1/textures

Request Parameters

• Headers:

  • Authorization : Bearer token for authentication (required)

  Response

  • Status Code: 200 OK

  • Body: Returns a JSON array of objects, each representing a texture with the following properties:

    • id: Unique identifier for the texture.

    • name: Name of the texture.

    • url: Direct URL to the texture file.

    • category: Category to which the texture belongs.

    Example Response

    [
      {
        "id": "texture_001",
        "name": "Wooden Texture",
        "url": "https://example.com/textures/wooden.jpg",
        "category": "Wood"
      },
      {
        "id": "texture_002",
        "name": "Metallic Texture",
        "url": "https://example.com/textures/metallic.jpg",
        "category": "Metal"
      }
    ]

  Use this endpoint to integrate texture data retrieval within your application. Ensure to handle authentication and JSON parsing to access the desired texture details.

Fetch all textures

get

Get a list of textures.

Authorizations

Query parameters

per_pageintegerOptional

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

Example: 25

pageintegerOptional

Number of page

Example: 2

order_bystringOptional

Field to order by (default: created_at)

Example: name

orderstring · enumOptional

Sorting order (asc or desc)

Example: descPossible values:

category_idintegerOptional

Filter by category ID

Example: 2

Responses

200

Successful response

application/json

401

Unauthorized

500

Internal Server Error

get

HTTPcURLJavaScriptPython

GET /api/open-api/v1/textures HTTP/1.1
Host: app.simplio3d.com
Authorization: Bearer JWT
Accept: */*

[
  {
    "id": 1,
    "name": "Wood Texture",
    "texture_file": "https://example.com/textures/wood_texture.jpg",
    "texture_thumbnail_50": "https://example.com/textures/wood_texture_50.jpg",
    "texture_thumbnail_100": "https://example.com/textures/wood_texture_100.jpg",
    "bump_file": "https://example.com/textures/wood_texture_bump.jpg",
    "category_id": 3,
    "created_at": "2024-02-21T12:34:56Z",
    "updated_at": "2024-02-21T12:34:56Z"
  }
]

GET /textures/{id}

Get Texture by ID

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

Request Parameters

• Path Parameters:

  • Id: The unique identifier of the texture (required).

Get texture by ID

get

Get a specific texture by ID.

Authorizations

Path parameters

idinteger · int64Required

ID of the texture

Example: 1

Responses

200

Successful response

application/json

401

Unauthorized

404

Texture not found

get

HTTPcURLJavaScriptPython

GET /api/open-api/v1/textures/{id} HTTP/1.1
Host: app.simplio3d.com
Authorization: Bearer JWT
Accept: */*

{
  "id": 1,
  "name": "Wood Texture",
  "texture_file": "https://example.com/textures/wood_texture.jpg",
  "texture_thumbnail_50": "https://example.com/textures/wood_texture_50.jpg",
  "texture_thumbnail_100": "https://example.com/textures/wood_texture_100.jpg",
  "bump_file": "https://example.com/textures/wood_texture_bump.jpg",
  "category_id": 3,
  "created_at": "2024-02-21T12:34:56Z",
  "updated_at": "2024-02-21T12:34:56Z"
}