Documentation of Contact Grabber WebService version 4.0

Getting Signature Key

Inorder to use the trial, you need to generate the key here http://stescodes.com/trial.aspx. You shall get the key based on the selection of plan.

Contact Grabber

Reference

• Add reference to stescodes_eval.dll on your project bin folder
• Import the namespace "stescodes_eval"
• Right click on your solution and click "Add Web Reference"
• Provide "https://www.stescodes.com/stescodescontactgrabber.asmx" in the url field and click GO
• Provide Web reference_name (eg: contactgrabber_cg)
• Click Add_Reference, now you can access the below functions
  • Direct Methd:
    • GrabContacts
  • OAUTH Methd:
    • GetAuthenticationUrl
    • GetAccessToken
    • GrabContacts_OAuth
• Check out the WSDL link here https://www.stescodes.com/​stescodescontactgrabber.as​mx?wsdl

Settings

Add the below appsettings on your web.config file

    <add key="gmailapikey" value="Your gmail consumer or api key"/>
    <add key="gmailapisecret" value="Your gmail consumer or api secret key"/>

    <add key="consumerKey_yahoo" value="Your yahoo consumer or api key"/>
    <add key="consumerSecret_yahoo" value="Your yahoo consumer or api secret key"/>

    <add key="liveapiKey" value="Your live consumer or api key"/>
    <add key="livesecretKey" value="Your live consumer or api secret key"/>
            

Direct method

Function

GrabContacts(servicename, strUserName, strPassword, signaturekey);

Parameters for Direct method

Return Type

1. Email
2. Name

OAuth method

To start grabbing contacts using OAuth Method, you have to make request to three functions

1. GetAuthenticationUrl
2. GetAccessToken
3. GrabContacts_OAuth

To configure API keys in Gmail, Yahoo and Windows Live, click here How to configure API keys.

Function for GetAuthenticationUrl function

GetAuthenticationUrl(servicename, ConsumerKey, ConsumerSecret, callbackurl, policyurl);

Parameters

Return type

1. Token
2. TokenSecret
3. UID
4. AuthURL

Function for GetAccessToken function

GetAccessToken(servicename, ConsumerKey, ConsumerSecret, callbackurl, token, tokensecret, tokenverifier);

Parameters

Return type

1. Token
2. TokenSecret
3. UID
4. AuthURL

Function for GrabContacts_OAuth function

GrabContacts_OAuth(servicename, token, tokensecret, tokenverifier, UID, signaturekey, ConsumerKey, ConsumerSecret);

Parameters

Return Types

1. Email
2. Name

Debugging

Debugging Gmail:

1. Create API key with the localhost url as return url(when going live, change the return url to live url)
2. Replace the api key and secret key in web.config file
3. Replace the already provided localhost url in oauth.aspx.cs file
4. Then try with breakpoints to debug

Debugging Yahoo:

1. Create API key with the localhost url as return url(when going live, change the return url to live url)
2. Replace the api key and secret key in web.config file
3. Then try with breakpoints to debug

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

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.