Follow @TeamWAPI

Tweet

Suivresur

Integrate WIT-DataCenter plateform from Windows Store, Web ASP.NET or Desktop Apps

Install

• WIT.DataCenter.DTOs.dll:DTOs = Data Tranfer Object = entities return by WAPI
  
• WIT.DataCenter.SDK.Common.dll: portable library with WAPI Proxy
  
• WIT.DataCenter.SDK.dll:custom WAPI sdk related to project type
  

Configuration and usage depend from project type:

Windows Store App (8.1)

Configure App credentials

      public App()
        {
            this.InitializeComponent();
            this.Suspending += OnSuspending;
            WAPIClient.Current.Initialize("YOUR_APP_ID", "YOUR_APP_SECRET", "YOUR_APP_NAME");
        }

Call WAPI Operation

      // Initialize Operation
      var operation = new GetBusinessAccountsMy(updatedDate: null);
            
      // Request Operation (here BusinessAccountDto array is returned)
      var response = await WAPIHelper.RequestAsync(operation);

Asp.NET App

Configure App credentials

client identity="YOUR_APP_ID" secret="YOUR_APP_SECRET" name="YOUR_APP_NAME"

Request a Token

1. When end-user need to access WAPI Operation for the first time, redirect him to WIT-DataCenter autorization server

   WAPIClient.Current.RequestAuthorization()

2. On callback, request a definitive WAPIToken for current end-user (method is async)

   var wapiToken = await WAPIClient.Current.ProcessAuthorizationAsync()

   Remark

   View OAuth doumentation for detailed Authorization Code Grant Workflow

3. Store WAPIToken in current end-user repository for future use
   Remark

   End-user must be autenticated in your WebApp to associate WAPIToken

Call WAPI Operation

      // Get WAPIToken
      IWAPIToken wapiToken = ... 
     
      // Initialize Operation
      var operation = new GetBusinessAccountsMy(updatedDate: null);
            
      // Request Operation (here BusinessAccountDto array is returned)
      var response = await WAPIClient.Current.RequestAsync(operation, wapiToken);

Refresh a Token

1. When access_token expiration is imminent, refresh:

   await WAPIClient.Current.RefreshWAPITokenAsync()

   Remark

   View OAuth documentation for detailed OAuth 2.0 Refresh workflow

2. Store refreshed WAPIToken in current end-user repository