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

/api/open-api/v1/textures

Get a list of textures.

Authorizations

AuthorizationstringRequired

Enter token in format (Bearer <your_token>)

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

Textures data response

idintegerOptionalExample: 1

namestringOptionalExample: Wood Texture

texture_filestring · urlOptionalExample: https://example.com/textures/wood_texture.jpg

texture_thumbnail_50string · urlOptionalExample: https://example.com/textures/wood_texture_50.jpg

texture_thumbnail_100string · urlOptionalExample: https://example.com/textures/wood_texture_100.jpg

bump_filestring · urlOptionalExample: https://example.com/textures/wood_texture_bump.jpg

category_idintegerOptionalExample: 3

created_atstring · date-timeOptionalExample: 2024-02-21T12:34:56Z

updated_atstring · date-timeOptionalExample: 2024-02-21T12:34:56Z

401

Unauthorized

500

Internal Server Error

get/api/open-api/v1/textures

GET /api/open-api/v1/textures HTTP/1.1
Host: app.simplio3d.com
Authorization: Bearer YOUR_SECRET_TOKEN
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

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

Get a specific texture by ID.

Authorizations

AuthorizationstringRequired

Enter token in format (Bearer <your_token>)

Path parameters

idinteger · int64Required

ID of the texture

Example: 1