REST API Reference
Spatial Commerce REST Endpoints
Direct HTTPS endpoints for headless spatial rendering, catalog synchronization, and automated estimations.
POST
/v1/spatial/segment
Extracts 3D perspective geometry and multi-surface masks (floor, wall, ceiling, furniture) from a user-uploaded photograph.
curl -X POST https://api.homyzosystem.com/v1/spatial/segment \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{ "image_url": "https://cdn.domain.com/room.jpg" }'
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{ "image_url": "https://cdn.domain.com/room.jpg" }'
POST
/v1/spatial/render
Renders PBR materials (tiles, marble bookmatch, paint, wood slats) onto segmented surfaces with lighting preservation.
curl -X POST https://api.homyzosystem.com/v1/spatial/render \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{ "room_id": "room-living-01", "sku": "HZ-TL-901", "lighting": "evening" }'
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{ "room_id": "room-living-01", "sku": "HZ-TL-901", "lighting": "evening" }'