durl Open API

Open API

Durl provides REST OpenAPI to allow (web)application developers to use Durl's service.

You can easily reduce longurl to shorturl and get the snapshot image of website longurl denotes.

Creation

api

http://snap.daum.net/api/Create.do

param

longurl: Long url you want to reduce
servicename: Specify name of your service
type(optional): "xml" or "json", default value is "xml"
callback(optional): Until you specify a type as "json", this param has no meaning. It denotes a callback function name user defined.
width(optional): Specify a width of captured image. If this param's value is 0 or you don't specify, it will fit proper size. Max value is 1024
height(optional): Specify a height of captured image. If this param's value is 0 or you don't specify, it will fit proper size. Max value is 2000

return value

xml

structure
- status: "ok" or "invalid"
- long-url: original url
- short-url: reduced url
- key: identifier
structure example
- <?xml version="1.0" encoding="UTF-8"?> <durl> <status>ok</status> <long-url>http://www.yahoo.com/somepath</long-url> <short-url>http://snap.daum.net/5o</short-url> <key>5o</key> </durl>

json

structure
- status: "ok" or "invalid"
- longUrl: original url
- shortUrl: reduced url
- key: identifier
structure example
- { "longUrl":"http://www.yahoo.com/somepath", "status":"ok", "shortUrl":"http://snap.daum.net/5o", "key":"5o" }
- if you specify a callback function name as "jsFunc" jsFunc({ "longUrl":"http://www.yahoo.com/somepath", "status":"ok", "shortUrl":"http://snap.daum.net/5o", "key":"5o" })

Status Checking

api

http://snap.daum.net/KEY.status

param

type(optional): "xml" or "json", default value is "xml"
callback(optional): Until you specify a type as "json", it has no meaning. This param denotes callback function name user defined.

return value

xml

structure
- key: identifier
- image-ready: "yes" or "no"
- image-url-small: small(400x300) png image url
- image-url-big: big(1024x768) png image url
structure example
- <?xml version="1.0" encoding="UTF-8"?> <durl> <key>5o</key> <image-ready>yes</image-ready> <image-url-small>http://image.snap.daum.net/A2D4G5B7H9</image-url-small> <image-url-big>http://image.snap.daum.net/A2B8D9G5</image-url-big> </durl>

json

structure
- key: identifier
- imageReady: "yes" or "no"
- imageUrlSmall: small(400x300) png image url
- imageUrlBig: big(1024x768) png image url
structure example
- { "imageUrlSmall":"http://image.snap.daum.net/A2D4G5B7H9", "imageReady":"yes", "imageUrlBig":"http://image.snap.daum.net/A2B8D9G5", "key":"5o" }
- if you specify a callback function name as "jsFunc" jsFunc({ "imageUrlSmall":"http://image.snap.daum.net/A2D4G5B7H9", "imageReady":"yes", "imageUrlBig":"http://image.snap.daum.net/A2B8D9G5", "key":"5o" })

Snapshot Image

api

http://snap.daum.net/KEY.image

return value

png image data

Open API Example

1. if you want to reduce a long url like

http://www.google.co.kr/search?complete=1&hl=ko&q=why+worry&lr=&aq=5&oq=why

just call Create.do

http://snap.daum.net/api/Create.do?longurl=http%3A//www.google.co.kr/search%3Fcomplete%3D1%26hl%3Dko%26q%3Dwhy%2Bworry%26lr%3D%26aq%3D5%26oq%3Dwhy

and then you can get xml data like below.

if you specify type=json like

http://snap.daum.net/api/Create.do?type=json&longurl=http%3A//www.google.co.kr/search%3Fcomplete%3D1%26hl%3Dko%26q%3Dwhy%2Bworry%26lr%3D%26aq%3D5%26oq%3Dwhy

you can get json data like below

if you want to use a callback function helloCallback directly in your javascript code,

just add callback=helloCallback

http://snap.daum.net/api/Create.do?type=json&callback=helloCallback&longurl=http%3A//www.google.co.kr/search%3Fcomplete%3D1%26hl%3Dko%26q%3Dwhy%2Bworry%26lr%3D%26aq%3D5%26oq%3Dwhy

then you can get json data like below

2. You got a key "bt2" and short url

http://snap.daum.net/bt2

Then you want to get bt2's snapshot image

just add .image

http://snap.daum.net/bt2.image

3. Website snapshot takes a time for a while. so if you want to know that it has finished capturing a snapshot of website,

just add .status

http://snap.daum.net/bt2.status

then you can get xml data like below

if you want json data,

specify type=json

http://snap.daum.net/bt2.status?type=json

then you can get json data like below

if you want to add callback function,

specify callback=callbackNameYouwant

http://snap.daum.net/bt2.status?type=json&callback=callbackNameYouwant

then you can get json data like below

That's all.

Isn't it easy?

durl

Skip Navigation List

Open API

Creation

api

param

return value

xml

json

Status Checking

api

param

return value

xml

json

Snapshot Image

api

return value

Open API Example

Contents Area

Copyright Information Area