Documentation of Social Event Manager WebService version 1.0

AutoUpdate DLL

Parameters

Social Event Manager

Reference

• Add reference to StesCodes_em.dll
• Import the namespace "socialevent"

Settings

Add the below appsettings on your web.config file only for Plan D

   <add key="signaturekey" value="Your Signature key"/>


    <!--////////////////   SOCIAL EVENTS   ///////////////-->
    
    <!-- To get Google Events api key use this  https://code.google.com/apis/console/?pli=1#welcome:  -->
    <add key="googleapikey_EM" value="Google API key here"/>
    <add key="googleapisecret_EM" value="Google API secret key here"/>
    
    <!-- To get Yahoo Events api key use this  https://developer.apps.yahoo.com/projects  -->
    <add key="upcomingapikey_EM" value="Upcoming api key here"/>
    <add key="upcomingapisecret_EM" value=""/>
    
    <!-- To get Live Events api key use this  https://manage.dev.live.com  -->
    <add key="liveapikey_EM" value="Live api key here"/>
    <add key="liveapisecret_EM" value="live api secret key here"/>
    <add key="policyurl" value="your policy page url"/>
    
    <!-- To get Facebook Events api key use this http://www.facebook.com/developers/ -->
    <add key="facebookapikey_EM" value="Facebook API key here"/>
    <add key="facebookapisecret_EM" value="Facebook API secret key here"/>
    
    <!-- To get Live Events api key use this  http://www.last.fm/api/account  -->
    <add key="lastfmapikey_EM" value="last.FM API key here "/>
    <add key="lastfmapisecret_EM" value="last.FM secret key here"/>
            

OAuth method

To start grabbing friends using OAuth Method, you have to make request to three functions(this applies for Twitter and LinkedIn)

1. getAuthenticationUrl
2. getAccessToken
3. GetEvents
4. CreateEvents

To configure API keys, click here How to configure API keys.

Function for getAuthenticationUrl function

authdetails list_ut = getAuthenticationUrl(servicename, ConsumerKey, ConsumerSecret, callbackurl, policyurl);

Parameters

Return type

1. authurl
2. Token
3. TokenSecret
4. TokenVerifier
5. UID
6. error

Function for getAccessToken function

authdetails listau = getAccessToken(servicename, ConsumerKey, ConsumerSecret, callbackurl, token, tokensecret, tokenverifier, signature, Context);

Parameters

Return type

1. authurl
2. Token
3. TokenSecret
4. TokenVerifier
5. UID
6. error

Function for GetEvents

List<eventdetails> list_ed = GetEvents(servicename, token, tokensecret, ConsumerKey, ConsumerSecret, uid, signature, this.context);

Parameters

Return Types

1. eventurl
2. calendarname
3. endtime
4. id
5. location
6. name
7. rsvp
8. picture
9. starttime
10. description
11. error

Function for CreateEvents

string status = sendInvitation(serviceName, Token, TokenSecret, ename, edesc, estartdate, estarttime, eenddate, eendtime, elocation, eRSVP, ConsumerKey, ConsumerSecret, signature);

Parameters

Return Types

Debugging

Debugging Windows Live:

1. Upload the auth.aspx page to your server.
2. Do the below five steps when the user is redirected after authentication.
3. Get the post data and construct as a url with querystring parameter(for ex: token=xxx&tokensecret=yyyy as http://youdomain.com/auth.aspx?token=xxx&tokensecret=yyyy)
4. After constructing the parameter change the constructed url to localhost url(for ex: http://youdomain.com/auth.aspx?token=xxx&tokensecret=yyyy to http://localhost:2345/yourproject/auth.aspx?token=xxx&tokensecret=yyyy
5. Redirect to the localhost url(for ex: Response.Redirect(http://localhost:2345/yourproject/auth.aspx?token=xxx&tokensecret=yyyy);)
6. Now you will get the token in localhost for debugging.
7. Remove the redirection part after you done with your debugging.

Binding

Error Handling

Error Message

Configurations

Inorder to perform the autoupdate process successfully, your project should be read/write enabled. Once found update, two files will be updated, one is Social Event Manager dll which is inside bin folder and other is stescodes.im which is outside the bin folder. The stescodes.im file has the details of update info.

If you don't want to provide write permission for the entire project, then follow the below steps:

• Create a folder with write permission or specify a folder with write permission for IMfile
• Pass the location of folder to "checkforupdate" function as fourth parameter(eg: checkforupdate(this.Context, signature,bin location,IMfile location);)
• Also specify the path as additional parameter to "grabFriends"(specify as third parameter) function

Permissions

Turn On/Off AutoUpdate

Turn OFF:

In order to turn off autoupdate, login to http://stescodes.com/sourceupdate.aspx then click OFF button. Once autoupdate is set OFF, the DLL with latest updates will not be updated on your server automatically, you have to manually update by downloading the latest DLL from customer login. No need to providing write permission for bin folder.

Even though you turn OFF the autoupdate feature, you should have the below on your project.

• Either you should create a folder with write permission OR provide write permission to root folder. This process is necessary for the stescodes.im file to be created which keeps track of the service validations.
• If you create a folder with write permission then specify that location as parameter for "autoupdate" function and "grabFriends" function(refer above for passing parameter).

Turn ON:

In order to turn ON autoupdate, login to http://stescodes.com/sourceupdate.aspx then click ON button. Once autoupdate is set ON, the DLL with latest updates will be updated on your server automatically.

If you turn ON the autoupdate feature, you should have the below on your project

• Either you should create a folder with write permission OR provide write permission to root folder.
• If you create a folder with write permission then specify that location as parameter for "autoupdate" function and "grabFriends" function(refer above for passing parameter).

Change Domain

Edit/Change Domain

• Login to http://stescodes.com/sourceupdate.aspx
• You shall login using email and password which you received in email during purchase or you shall use the StesCodes transaction id
• Once you login, click the edit link near website
• Enter the domain details
• Click "proceed" to save.