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

Response containing 360-degree product image information.

activatebooleanRequired

Indicates if 360° viewing is available for this product.

When false, the images array will be empty.

Example: true

imagesstring · uri[]Required

Ordered list of image URLs for 360° rotation.

Images should be displayed in sequence to create the rotation effect. Typical sequences contain 24-72 images (representing 15° or 5° intervals).

Example: ["https://cdn.akinon.com/360/product-001.jpg","https://cdn.akinon.com/360/product-002.jpg","https://cdn.akinon.com/360/product-003.jpg"]

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

Response containing the transformed image URL.

image_urlstring · uriRequired

URL of the transformed image.

This URL can be used directly in <img> tags or CSS backgrounds. The transformed image is cached for performance.

Example: https://cdn.akinon.com/transform/abc123.webp

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"
}