Generate safe links from your site or App!
With a simple HTTP call, you can generate SafeShare links from your own site or application. The API is straightforward and dead simple. This document describes how to do it.
For previous API, try the Legacy Version
You need to make a GET or a POST request to this URL:
The request should have some parameters in the query-string or the request body. Check out the details of parameters and response patterns in the tables below.
|JSONP||If supplied, the response come in JSONP format. Example: jsonp=callback||Optional|
|url (required)||Link to the Youtube or Vimeo video page. For example: http://www.youtube.com/watch?v=jNQXAC9IVRw||Valid URL to Youtube or Vimeo video|
|title||This will be the title you want to show on your video. If you don't send, be the video title||Maximum 200 characters|
|description||Description and/or additional information of the video. If you don't send, the description of video will be cropped by 200 chars||Maximum 200 characters|
|start||Define where the video should start playing||In seconds; should be somewhere within total video length|
|end||Define where the video should stop playing||In seconds; should be somewhere within total video length. Shouldn't be smaller than start|
Response Format Sample
The response is sent in JSON or JSONP format. The JSON contains information to let you build your application. This table explains the response:
"status":"success","message":"Safeview was created!",
"title":"Me at the zoo","icon":"http://safeshare.tv/api/serviceimage/ss56218633d0778",
"description":"The first video on YouTube.\n\nMaybe it's time to go back to the zoo?",
|callback||Function callback, if you pass a JSONP function, it will be returned.|
|status||Defines the status of your request. success is returned if the request was successful. error is returned if the request failed.|
|message||A human readable message that confirms the success or explains the error if there is any.|
Contains data of the created SafeShare entry if the request was successful. It contains these fields: