Advanced API

The Advanced API is an interface to interact with the Hictu platform and write your contents. You can get data via XML. You do not need a Developer API Key to use the Simple API. The Simple API lets you quickly get lots of data about a user, group, channel, or album in a variety of formats.

Get a Developer API Key

If you want to get a Hictu API Key, just send an e-mail to [email protected] specifying your name and the website in wich you wish to use the Hictu capabilities.

Authorization

It lets you verify Userid and Password of a Hictu user. The response can be obtained calling the following url though POST method.

Example Request

http://www.hictu.com/api/auth.php

Our full argument list follows:

api_id             your api id
api_pwd        your api password
method          auth
hictu_id         hictu userid
hictu_pwd    hictu password [or hictu_pwdmd5 = hictu password in md5]

api_id and api_pwd must be part of the HTTP authentication header

Example Responses

In case of not supported method:

<response>
    <status>KO</status>
    <error>Method Not Allowed</error>
</response>

In case of user not allowed:

<response>
    <status>KO</status>
    <error>Authentication Failed</error>
</response>

In case of allowed user:

<response>
    <status>OK</status>
</response>

Post

It lets you post a text message after having been authorized. The response can be obtained calling the following url though POST method.

Example Request

http://www.hictu.com/api/sendPost.php

Our full argument list follows:

api_id             your api id
api_pwd        your api password
method          "sendpost"
hictu_id         hictu userid
hictu_pwd    hictu password [or hictu_pwdmd5 = hictu password in md5]
msgbody      message body
fileurl             media url (if any)

api_id and api_pwd must be part of the HTTP authentication header

Example Responses

In case of not supported method:

<response>
    <status>KO</status>
    <error>Method Not Allowed</error>
</response>

In case of user not allowed:

<response>
    <status>KO</status>
    <error>Authentication Failed</error>
</response>

In case of fileurl bigger than 256 chars:

<response>
    <status>KO</status>
    <error>Invalid fileurl</error>
</response>

In case of sending error:

<response>
    <status>KO</status>
    <error>SendPost Error</error>
</response>

In case of empty message or bigger than 160 chars:

<response>
    <status>KO</status>
    <error>msgbody field too long or empty</error>
</response>

In case of success:

<response>
    <status>OK</status>
    <msgid>[message id]</msgid>
</response>

Video Post

It lets you post a video message from an external website. In order to power your blog/website with video-posting feature, you have to download Hictu Message Recorder from here, unzip the archive and upload the file MessageRecorder.swf in your server at the path httpRoot/flash/MessageRecorder.swf

Integration in your site

Insert the following js in the <head> section:

<!-- START HICTU CODE – external script import -->
<script src="http://www.hictu.com/javascript/swfobjectAPI.js" type="text/javascript"></script>
<!-- END HICTU CODE - external script import -->

Insert the following code where you want the Video Recoreder to be shown:

<!-- START HICTU CODE - show video recorder -->
<div id="flashRecorder" style='display:block;'>
   <a href="http://www.adobe.com/go/getflashplayer">GET FLASH</a>
</div>
<script type="text/javascript">
   writeMessageRecorder('flashRecorder', 'HICTU_USERNAME', 'rtmp://151.9.176.184/multimediaPost', 'en');
</script>
<!-- END HICTU CODE - show video recorder -->

The variable HICTU_USERNAME must be the username of the current Hictu user.

If you have a submit form (i.e. a text post form), modify the form by inserting the following hidden fields:

<!-- START HICTU CODE - customized fields -->
<input type="hidden" id="hictu_mediaFile" name="hictu_mediaFile" value="" />
<input type=" hidden " id="hictu_mediaType" name="hictu_mediaType" value="1" />
<!-- END HICTU CODE - customized fields -->

When video recording has finished, the field hictu_mediaFile will be equal to the name of the video just created. This name can be used to create the thumbnail for the video.

<img src="http://www.hictu.com/videoscreenshots/$hictu_mediaFile.jpg" style="height:80px;width:106px;"/>

If you need in-depth info about the posted video, you can use our Video Request API