home
  Home    Profile     Find People     Settings     Help / Feedback     Features     Logout   
br.st API
Use of the br.st API requires an API key. You can get an API key from the Settings section once you login.

Thumbnails of shared images

Shared Link: http://br.st/0hS
Small Thumbnail: http://br.st/brst.service/file/0hS~small.jpg (150x150)
Tiny Thumbnail: http://br.st/brst.service/file/0hS~thumb.jpg (78x78)

If you display a br.st thumbnail you must link back to the original br.st share link on the image or near it.


API Code Examples
VB.NET
C#
PHP
AS3 (Flex)

VB.NET

'BEGIN: Generate a short URL
Dim API_KEY As String = "00000000-0000-0000-0000-000000000000"
Dim oBRST As New st.br.Service
Dim oResult As st.br.GenerationResult = Nothing
oResult = oBRST.URLGenerateAlias("http://yourdomain.com", Nothing, API_KEY)
oBRST = Nothing

If oResult.wasSuccessful Then
     Response.Write("aliasID: " & oResult.aliasID & "<br />")
     Response.Write("aliasURL: " & oResult.aliasURL & "<br />")
     Response.Write("destTitle: " & oResult.destTitle & "<br />")
     Response.Write("destURL: " & oResult.destURL & "<br />")
     Response.Write("Message: " & oResult.Message & "<br />")
Else
     Response.Write(oResult.Message & "<br />")
End If

oResult = Nothing
'END: Generate a short URL
'BEGIN: Retreive Info on a short URL
Dim API_KEY As String = "00000000-0000-0000-0000-000000000000"
Dim oBRST As New st.br.Service
Dim oAliasInfo As st.br.AliasInfo = Nothing
oAliasInfo = oBRST.URLGetAliasDetails("74", API_KEY)
oBRST = Nothing

If oAliasInfo.Success Then
     Response.Write("aliasID: 74")
     Response.Write("aliasURL: " & "http://br.st/74")
     Response.Write("ContentType: " & oAliasInfo.ContentType)
     Response.Write("DateActivated: " & oAliasInfo.DateActivated)
     Response.Write("DateModified: " & oAliasInfo.DateModified)
     Response.Write("MetaData: " & oAliasInfo.MetaData)
     Response.Write("Title: " & oAliasInfo.Title)
     Response.Write("TotalClicks: " & oAliasInfo.TotalClicks)
     Response.Write("URL: " & oAliasInfo.URL)
     Response.Write("Message: " & oAliasInfo.Message)
Else
     Response.Write(oAliasInfo.Message)
End If

oAliasInfo = Nothing
'END: Retreive Info on a short URL

C#

//BEGIN: Generate a short URL
string API_KEY = "00000000-0000-0000-0000-000000000000";
st.br.Service oBRST = new st.br.Service();
st.br.GenerationResult oResult = new st.br.GenerationResult();
oResult = oBRST.URLGenerateAlias("http://yourdomain.com", null, API_KEY);
oBRST = null;
if (oResult.wasSuccessful)
{
     Response.Write("aliasID: oResult.aliasID" + "<br />");
     Response.Write("aliasURL: oResult.aliasURL" + "<br />");
     Response.Write("destTitle: oResult.destTitle" + "<br />");
     Response.Write("destURL: oResult.destURL" + "<br />");
     Response.Write("Message: oResult.Message" + "<br />");
} else {
     Response.Write(oResult.Message + "<br />");
}

oResult = null;
//BEGIN: Retreive Info on a short URL
string API_KEY = "00000000-0000-0000-0000-000000000000";
st.br.Service oBRST = new st.br.Service();
st.br.AliasInfo oAliasInfo = null;
oAliasInfo = oBRST.URLGetAliasDetails("74", API_KEY);
oBRST = null;

if (oAliasInfo.Success == "true")
{
     Response.Write("aliasID: 74 <br />");
     Response.Write("aliasURL: http://br.st/74 <br />");
     Response.Write("ContentType: " + oAliasInfo.ContentType + "<br />");
     Response.Write("DateActivated: " + oAliasInfo.DateActivated + "<br />");
     Response.Write("DateModified: " + oAliasInfo.DateModified + "<br />");
     Response.Write("MetaData: " + oAliasInfo.MetaData + "<br />");
     Response.Write("Title: " + oAliasInfo.Title + "<br />");
     Response.Write("TotalClicks: " + oAliasInfo.TotalClicks + "<br />");
     Response.Write("URL: " + oAliasInfo.URL + "<br />");
     Response.Write("Message: " + oAliasInfo.Message + "<br />");
} else {
     Response.Write(oAliasInfo.Message + "<br />");
}

oAliasInfo = null;
//BEGIN: Retreive Info on a short URL

PHP

<?php
$client = new
  SoapClient(
    "https://br.st/brst.service/service.asmx?wsdl"
  );


$result = $client->URLGenerateAlias(array(
    'URL'=>"http://yourdomain.com",
    'CustomAlias'=>"alias",
    'apiKey'=>"00000000-0000-0000-0000-000000000000")
    );

print("URLGenerateAlias: \n\n");
print("Successful: ".$result->URLGenerateAliasResult->wasSuccessful."\n");
print("Message: ".$result->URLGenerateAliasResult->Message."\n");
print("AliasID: ".$result->URLGenerateAliasResult->aliasID."\n");
print("AliasURL: ".$result->URLGenerateAliasResult->aliasURL."\n");
print("DestURL: ".$result->URLGenerateAliasResult->destURL."\n");
print("DestTitle: ".$result->URLGenerateAliasResult->destTitle."\n");

print("\n\n\n\n\n");

$result2 = $client->URLGetAliasDetails(array(
    'aliasID'=>"ct",
    'apiKey'=>"00000000-0000-0000-0000-000000000000")
    );

print("URLGetAliasDetails: \n\n");
print("Successful: ".$result2->URLGetAliasDetailsResult->Success."\n");
print("Message: ".$result2->URLGetAliasDetailsResult->Message."\n");
print("URL: ".$result2->URLGetAliasDetailsResult->URL."\n");
print("Title: ".$result2->URLGetAliasDetailsResult->Title."\n");
print("Total Clicks: ".$result2->URLGetAliasDetailsResult->TotalClicks."\n");
print("AliasURL: ".$result2->URLGetAliasDetailsResult->aliasURL."\n");
print("Date Activated: ");
print($result2->URLGetAliasDetailsResult->DateActivated."\n");
print("Date Modified: ".$result2->URLGetAliasDetailsResult->DateModified."\n");

?>

Action Script 3

<?xml version="1.0" encoding="utf-8"?>
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml" layout="absolute"
creationComplete="init();" backgroundGradientAlphas="[1.0, 1.0]"
backgroundGradientColors="[#FFFFFF, #FFFFFF] >
<mx:Script>
<![CDATA[
import mx.rpc.events.ResultEvent;
import mx.rpc.events.FaultEvent;
import mx.controls.Alert;
[Bindable] private var longURL:String;
[Bindable] private var aliasID:String;
[Bindable] private var apiKey:String;

private function init():void{
Security.allowDomain("br.st");
Security.allowInsecureDomain("br.st");
this.longURL = "http://www.brinkster.com";
this.apiKey = "00000000-0000-0000-0000-000000000000";
this.aliasID = "74";
//this.brstService.URLGenerateAlias.send();
this.brstService.URLGetAliasDetails.send();
}

private function handleGenerationResult(e:ResultEvent):void{
var xmlData:XML;
xmlData = XML(e.result);
var xList:XMLList;
xList = xmlData.children();
var txtOutput:String;
for each (var x:XML in xList) {
txtOutput = "wasSuccessful: " + x.@wasSuccessful + "\n"
txtOutput += "Message: " + x.@Message + "\n"
txtOutput += "aliasID: " + x.@aliasID + "\n"
txtOutput += "aliasURL: " + x.@aliasURL + "\n"
txtOutput += "destURL: " + x.@destURL + "\n"
txtOutput += "destTitle: " + x.@destTitle
}

taOutput.text = txtOutput;
}

private function handleAliasDetailsResult(e:ResultEvent):void{
var xmlData:XML;
xmlData = XML(e.result);
var xList:XMLList;
xList = xmlData.children();
var txtOutput:String;
for each (var x:XML in xList) {
txtOutput = "Success: " + x.@Success + "\n"
txtOutput += "Message: " + x.@Message + "\n"
txtOutput += "Title: " + x.@Title + "\n"
txtOutput += "ContentType: " + x.@ContentType + "\n"
txtOutput += "MetaData: " + x.@MetaData + "\n"
txtOutput += "TotalClicks: " + x.@TotalClicks + "\n"
txtOutput += "aliasURL: " + x.@aliasURL + "\n"
txtOutput += "DateActivated: " + x.@DateActivated + "\n"
txtOutput += "DateModified: " + x.@DateModified
}

taOutput.text = txtOutput;
}

privatefunction handleFault(e:FaultEvent):void{
Alert.show("There was an error while connecting to the server. Reseting...\n"
+ e.fault.faultString + "\n" this.brstService.wsdl);
}
]]>
</mx:Script>

<mx:WebService id="brstService" wsdl="http://br.st/brst.service/service.asmx?WSDL"
fault="handleFault(event)" showBusyCursor="false" >
<mx:operation name="URLGenerateAlias" result="handleGenerationResult(event);"
resultFormat="e4x" makeObjectsBindable="true" >
<mx:request xmlns="">
<URL>{this.longURL}</URL>
<CustomAlias></CustomAlias>
<apiKey>{this.apiKey}</apiKey>
</mx:request>
</mx:operation>
<mx:operation name="URLGetAliasDetails" result="handleAliasDetailsResult(event);"
resultFormat="e4x" makeObjectsBindable="true">
<mx:request xmlns="">
<aliasID>{this.aliasID}</aliasID>
<apiKey>{this.apiKey}</apiKey>
</mx:request>
</mx:operation>
</mx:WebService>

<mx:TextArea horizontalCenter="0" verticalCenter="0" width="450" height="200" id="taOutput"/>
</mx:Application>
Home  •   FAQ’s  •   About Us  •   Blog  •   API  •   Privacy Policy  •   Terms of Service
Copyright © 2009 Brinkster Communications Corporation. All Rights Reserved.