Developer's Challenge

The following code will make an HTTP GET request to the Developer's Challenge API and log the request. You can then view the results in the status tab of the Developers Challenge Facebook application. Simply past your application key below along with a Facebook ID (integer) and submit the request.

This example uses a client side implementation of the httpRequest object in JavaScript. It has been tested for IE7 or less and Firefox. You may use this code in your application if you choose but be aware that if creating a native FBML application Javascript is limited and you should look at the new FBJS API that Facebook has released. This code is offered under the open source license. To download the Javascript object see the bottom of this document. If you need more information on using the AJAX API then please contact us on the Developers Challenge Home Page Discussion Board.

AJAX API Example Call and documentation

function doRequest(){

myRequest=new clsDevChallengeAPI()
myRequest.async=false;
myRequest.onSuccess=pass;
myRequest.onFailure=fail;
myRequest.appKey=[Your application key as string]
myRequest.fbid=[User Facebook ID as number]
myRequest.iText=[0=False | 1=True]
myRequest.iImage=[0=False | 1=True]
myRequest.iVideo=[0=False | 1=True]
myRequest.iRingTone=[0=False | 1=True]
myRequest.call()

function pass(){

Do something
}
function fail(){
Do something
}

}

DOCUMENTATION

Instantiation: Var myCaller = new clsDevChallengeAPI()

Properties

.rootPath Root Path of Web Service, should not be changed. Set to http://www.developerschangle.com/attfb.asmx/msg by default

.method Method of Call, should not be changed. Set to GET by default

.async Make the call Asyncrously or not. Set to False by default. The web service is very quick in its response and setting Async to true and making multiple rapid calls may result in missed responses.

.appKey You application key

.fbid User Facebook ID as number

.iText Set if text message has been sent, 1=true | 0 = False

.iImage Set if image message has been sent, 1=true | 0 = False

.iVideo Set if Video message has been sent, 1=true | 0 = False

.iRingTone Set if RingTone redirect has been requested, 1=true | 0 = False

.result Boolean indicating is last call was successfull

Events

.onSuccess Fires when call has completed and was successful. Set to function pointer

.onFailure Fires when call has completed and failed. Set to function pointer

.onLoading Standard HttpRequest Object State, set to function pointer

.onLoaded Standard HttpRequest Object State, set to function pointer

.onInteractive Standard HttpRequest Object State, set to function pointer

Methods

.call() Makes a call to the web service. Returns true or false on success of call when Async is set to False.

clsDevChallengeAPI Source Code
function clsDevChallengeAPI(){ var me=this; this.xmlhttp=new clsHTTPRequest() this.rootPath=String('http://www.developerschallenge.com/attfbdc.aspx?'); this.method='GET'; this.async=false; this.appKey=new String(''); this.fbid=new String(''); this.iText=new Number(0); this.iImage=new Number(0); this.iVideo=new Number(0); this.iRingTone=new Number(0) this.result=false; this.onSuccess=function(){}; this.onFailure=function(){}; this.onLoading=function(){}; this.onLoaded=function(){}; this.onInteractive=function(){}; this.call=function(){ try{ var pass=true if(isNaN(me.fbid)==true || isNaN(me.iText)==true || isNaN(me.iImage)==true || isNaN(me.iVideo)==true || isNaN(me.iRingTone)==true){pass=false} if(me.appKey.length!=36){pass=false} if(pass==false){ if(!me.async){me.onFailure()} return false } var urlString=new String(me.rootPath) urlString+='appKey='+ me.appKey; urlString+= '&fbid='+ me.fbid; urlString+= '&iText='+ me.iText; urlString+= '&iImage='+ me.iImage; urlString+= '&iVideo='+ me.iVideo; urlString+= '&iRingTone='+ me.iRingTone; this.xmlhttp.onreadystatechange=me.result; this.xmlhttp.open(me.method, urlString, me.async); this.xmlhttp.send() }catch(e){} return me.result } this.result=function(){ switch (me.xmlhttp.readyState) { case 1: try{me.onLoading()}catch(e){}; break; case 2: try{me.onLoaded()}catch(e){}; break; case 3: try{me.onInteractive()}catch(e){}; break; case 4: try{ me.result=me.xmlhttp.responseText if(me.result==1){ me.onSuccess() }else{ me.onFailure() } }catch(e){} break; } } // end result function clsHTTPRequest(){ var iexmlclasses=['Msxml2.XMLHTTP.6.0','Msxml2.XMLHTTP.5.0','Msxml2.XMLHTTP.4.0','Msxml2.XMLHTTP.3.0','Msxml2.XMLHTTP','Microsoft.XMLHTTP']; var httpObj=null; try{ httpObj= new XMLHttpRequest(); }catch(e){ for(var llp=0;llp<3;llp++){ try{ httpObj=new ActiveXObject(iexmlclasses[llp]); break; }catch(e){} } // end llop } // end catch if(httpObj==null){ return null }else{ return httpObj } } } // end object

Your application Key [appKey]
FaceBook User ID [fbid]
Text Message [iText]
Image Message [iImage]
Video Message [iVideo]
iRingTone Message [iRingTone]

.rootPath	Root Path of Web Service, should not be changed. Set to http://www.developerschangle.com/attfb.asmx/msg by default
.method	Method of Call, should not be changed. Set to GET by default
.async	Make the call Asyncrously or not. Set to False by default. The web service is very quick in its response and setting Async to true and making multiple rapid calls may result in missed responses.
.appKey	You application key
.fbid	User Facebook ID as number
.iText	Set if text message has been sent, 1=true \| 0 = False
.iImage	Set if image message has been sent, 1=true \| 0 = False
.iVideo	Set if Video message has been sent, 1=true \| 0 = False
.iRingTone	Set if RingTone redirect has been requested, 1=true \| 0 = False
.result	Boolean indicating is last call was successfull

.onSuccess	Fires when call has completed and was successful. Set to function pointer
.onFailure	Fires when call has completed and failed. Set to function pointer
.onLoading	Standard HttpRequest Object State, set to function pointer
.onLoaded	Standard HttpRequest Object State, set to function pointer
.onInteractive	Standard HttpRequest Object State, set to function pointer

AT&T Developer's Challenge Demo AJAX API Caller