Skip to main content

oEmbed

We implements the oEmbed protocol to allow seamless embedding of any space- and product-viewer on any website.

Our oEmbed endpoint is https://viewer.rooom.com/oembed

Parameters

ParameterRequiredDescription
urlYESURL of the viewer: https://viewer.rooom.com/product/* or https://viewer.rooom.com/space/* where * is the ID of the viewer you wish to embed.
maxwidthNoMaximum width of the returned viewer.
maxheightNoMaximum height of the returned viewer.

Response

A JSON response will be returned. Insert the html attribute of the response where you want your viewer to be embedded.

Example

Space-Viewer

Request

https://viewer.rooom.com/oembed?url=https://viewer.rooom.com/space/f7ef4851b8

Response

{
"provider_name": "rooom",
"provider_url": "https:\/\/www.rooom.com",
"type": "rich",
"version": "1.0",
"title": "demo rooom",
"height": 360,
"width": 640,
"author_name": "Demo Rooom",
"html": "<div class=\"rooom-embed-wrapper\"><iframe width=\"640\" height=\"360\" src=\"https:\/\/viewer.rooom.com\/space\/f7ef4851b8\" allow=\"autoplay; fullscreen; vr\" title=\"demo rooom\" frameborder=\"0\" webkitallowfullscreen=\"true\" class=\"\" mozallowfullscreen=\"true\" allowfullscreen=\"\" onmousewheel=\"\" allowvr=\"\"><\/iframe><\/div>",
"thumbnail_url": "https:\/\/storage.rooom.com\/store\/viewers\/5f1ebffecc408429264d9144\/preview.f2f630@512.jpg",
"thumbnail_width": 512,
"thumbnail_height": 288
}

Product-Viewer

Request

https://viewer.rooom.com/oembed?url=https://www.rooom.com/product/e725a9e18cb87bbc2977b73d4bdc65

Response

{
"provider_name": "rooom",
"provider_url": "https:\/\/www.rooom.com",
"type": "rich",
"version": "1.0",
"title": "Puky Bike Demo",
"height": 360,
"width": 640,
"author_name": "Demo Rooom",
"html": "<div class=\"rooom-embed-wrapper\"><iframe width=\"640\" height=\"360\" src=\"https:\/\/viewer.rooom.com\/product\/e725a9e18cb87bbc2977b73d4bdc65\" allow=\"autoplay; fullscreen; vr\" title=\"Puky Bike Demo\" frameborder=\"0\" webkitallowfullscreen=\"true\" class=\"\" mozallowfullscreen=\"true\" allowfullscreen=\"\" onmousewheel=\"\" allowvr=\"\"><\/iframe><\/div>",
"thumbnail_url": "https:\/\/storage.rooom.com\/store\/viewers\/5ebd7b94903c994867147144\/preview.9bb48c@512.jpg",
"thumbnail_width": 512,
"thumbnail_height": 288
}