Special

Special product features (360° images, image transformation)

Retrieve 360-degree product images

get

Returns a list of images for 360-degree product viewing functionality.

360° Product Views: Enables interactive product visualization where customers can rotate the product view. The images are typically:

• Captured at fixed angle intervals (e.g., every 10°)

• Sequenced for smooth rotation animation

• Optimized for web viewing

Response:

• activate: Boolean indicating if 360° view is available

• images: Array of image URLs in rotation sequence

Usage: Client-side JavaScript libraries can use the image sequence to create an interactive 360° viewer.

Path parameters

codestringRequired

Product code for 360° image lookup.

Must be alphanumeric (no slashes or special characters).

Example: SHOE12345Pattern: ^[a-zA-Z0-9]+$

Responses

200

360° images retrieved successfully

application/json

400

Invalid code format.

The code must be alphanumeric without special characters.

get

/product/360/{code}/

HTTPcURLJavaScriptPython

GET /product/360/{code}/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

{
  "activate": true,
  "images": [
    "https://cdn.akinon.com/360/product-001.jpg",
    "https://cdn.akinon.com/360/product-002.jpg",
    "https://cdn.akinon.com/360/product-003.jpg"
  ]
}

Proxy request to image transformation service

get

Proxies requests to an external image transformation service (Bukalemun).

Behavior: This endpoint acts as a pass-through proxy. All query parameters are forwarded directly to the configured external image service (Source: Dynamic/Real-time Configuration - BUKALEMUN_CONFIG).

Configuration: The external service URL and path are configured via BUKALEMUN_CONFIG setting:

• base_url: Base URL of the image service

• path: Service endpoint path (default: /polo_js/)

Note: The available query parameters depend on the external image service configuration. This endpoint does not validate or transform the parameters - they are passed through as-is to the external service.

Responses

200

Image URL retrieved successfully from external service

application/json

502

External service error.

The upstream image service returned an error or is unavailable.

get

/bukalemun/

HTTPcURLJavaScriptPython

GET /bukalemun/ HTTP/1.1
Host: sandbox.akinon.com
Accept: */*

{
  "image_url": "https://cdn.akinon.com/transform/abc123.webp"
}