Contents

oEmbed

Endpoint URL for oEmbed embedding. You can fetch the information, such as the URL of diagram viewers that uses iframe.

Method

GET

URL

https://cacoo.com/oembed.format?url=diagramURL
Example : https://cacoo.com/oembed.json?url=https%3A%2F%2Fcacoo.com%2Fdiagrams%2F00e77f4dc9973517

Format

json, xml

Authentication

Not necessary (The specified diagram needs to a public resource.)

Parameters

Parameter NameTypeContentDefaultExample
url(Required)StringURL of the diagram detail pagehttps://cacoo.com/diagrams/00e77f4dc9973517
maxwidthIntegerMaximum width of embedding viewer450600
maxheightIntegerMaximum height of embedding viewer350400

Response

FieldTypeDescriptionExample
typeStringMedia type.
  • rich - Only

rich
versionStringVersion of oEmbed1.0
titleStringTitle of DiagramWireframe
descriptionStringTitle of DescriptionCurrent project wireframe
author_nameStringOwner’s user name1MUJPfNEEeVUox35
provider_nameStringProvider nameCacoo
provider_urlStringProvider URLhttps://cacoo.com/
thumbnail_urlStringURL of thumbnail imagehttps://cacoo.com/diagrams/00e77f4dc9973517-w450-h350.png
thumbnail_widthIntegerWidth of thumbnail image450
thumbnail_heightStringHeight of thumbnail image350
htmlStringHTML for embedding
widthIntegerWidth of embedding viewer450
heightIntegerHeight of embedding viewer350

JSON Response Example

{
    "type": "rich",
    "version": "1.0",
    "title": "Wireframe",
    "description": "Current project wireframe",
    "author_name": "1MUJPfNEEeVUox35",
    "provider_name": "Cacoo",
    "provider_url": "https://cacoo.com/",
    "thumbnail_url": "https://cacoo.com/diagrams/00e77f4dc9973517-w450-h350.png",
    "thumbnail_width": 450,
    "thumbnail_height": 350,
    "html": "<iframe src="https://cacoo.com/diagrams/00e77f4dc9973517/view?w=448&h=320" width="450" height="350" frameborder="0" ></iframe>",
    "width": 450,
    "height": 350
}

XML Response Example

<?xml version="1.0" encoding="utf-8"?>
<oembed>
  <type>rich</type>
  <version>1.0</version>
  <title>Wireframe</title>
  <description>Current project wireframe</description>
  <author_name>1MUJPfNEEeVUox35</author_name>
  <provider_name>Cacoo</provider_name>
  <provider_url>https://cacoo.com/</provider_url>
  <thumbnail_url>https://cacoo.com/diagrams/00e77f4dc9973517-w450-h350.png</thumbnail_url>
  <thumbnail_width>450</thumbnail_width>
  <thumbnail_height>350</thumbnail_height>
  <html>&lt;iframe src="https://cacoo.com/diagrams/00e77f4dc9973517/view?w=448&amp;h=320" width="450" height="350" frameborder="0" &gt;&lt;/iframe&gt;</html>
  <width>450</width>
  <height>350</height>
</oembed>