oEmbed 작업하기

📘
이 기능을 사용하기 위해 별도의 API 인증이 필요하지 않습니다.

oEmbed

oEmbed는 웹사이트의 콘텐츠를 다른 페이지에 포함할 수 있도록 설계된 개방형 표준입니다.
이는 특정 종류의 미디어 콘텐츠를 외부 웹사이트에 쉽게 배치할 수 있는 방법을 제공합니다. 포함하려는 콘텐츠에 해당하는 특수 URL에 액세스하면 포함 가능한 요소를 포함하여 콘텐츠에 대한 자세한 정보를 얻을 수 있습니다.

위캔디오에서는 Play URL로 oEmbed를 사용하여 해당 비디오에 대한 포함 가능한 요소를 생성할 수 있습니다.

oEmbed 응답 받기

oEmbed API로 해당 콘텐츠의 정보를 아래와 같은 형식으로 요청합니다.

{oEmbed API endpoint}?url={콘텐츠 주소}&format={XML/JSON}

URL 스키마

GET https://play.wecandeo.com/oembed/?url={PlayURL}

GET https://play.wecandeo.com/oembed/?key={videoKey}

위캔디오 공급자 정보

provider_name: wecandeo
  provider_url: https://www.wecandeo.com/
  endpoints:
   schemes:
      https://play.wecandeo.com/video/v/*
   url: https://play.wecandeo.com/oembed/
   discovery: true
   example_urls:
      https://play.wecandeo.com/oembed/?url=https%3A%2F%2Fplay.wecandeo.com%2Fvideo%2Fv%2F%3Fkey%3DBOKNS9AQWrHDOWXC7DUr6tHd023xknvmIii8SOulPCMtAT1KxqmfHySho4pqLKNis4ZCy4IG7kZTQ431147TteoAieie
      https://play.wecandeo.com/oembed/?url=https%3A%2F%2Fplay.wecandeo.com%2Fvideo%2Fv%2F%3Fkey%3DBOKNS9AQWrHDOWXC7DUr6tHd023xknvmIii8SOulPCMtAT1KxqmfHySho4pqLKNis4ZCy4IG7kZTQ431147TteoAieie&format=json
...

비디오 삽입

응답에는 삽입 가능한 요소가 포함된 html 필드를 포함하여 JSON(또는 XML)형식의 여러 메타데이터가 제공됩니다.
이 반환된 데이터를 사용하여 사이트에 필요한 데이터를 삽입합니다.

Response Sample

{
  url: "https://play.wecandeo.com/video/v/?key=BOKNS9AQWrHDOWXC7DUr6tHd023xknvmIii8SOulPCMtAT1KxqmfHySho4pqLKNis4ZCy4IG7kZTQ431147TteoAieie",
  type: "video",
  version: "1.0",
  title: "WECANDEO Promote",
	author: "",
	author_url: "",
	provider_name: "wecandeo",
	description: "",
	thumbnail_url: "http://timgs.acs.wecandeo.com/thumb/513/20150724/17/2257_6c4bd_00000_640_360.jpg",
	duration: 59.2,
	thumbnail_width: 640,
	thumbnail_height: 360,
	html: "<div style="position:relative; padding-bottom:56.25%; overflow:hidden;"><iframe width="100%" height="100%" src="https://play.wecandeo.com/video/v/?key=BOKNS9AQWrHDOWXC7DUr6tHd023xknvmIii8SOulPCMtAT1KxqmfHySho4pqLKNis4ZCy4IG7kZTQ431147TteoAieie" frameborder="0" allowfullscreen="" style="position:absolute;"></iframe></div>",
	cache_age: 86400,
}