Page History

...

Before undertaking any web service development, we need to ensure and have at hand crucial information that we need to establish a valid web service communication with our solution.  This includes the address of the server we are going to communicate with, the user credentials and the name of the solution.  The steps below will explain how to get each of these:

1. Identify the server URL or IP address that contains the solution you wish to integrate with.  In this example,

   I

   we may have a small solution

   on the

   a server called 'https://

   sandbox.eccentex

   acme.com/' called 'AppBase Training' that we would like to interface with:
   Image Modified
   
   Our server URL would therefore be https://

   sandbox.eccentex

   acme.com/
   
   

   Note
   title Server URL
   The above URL is an example only.  Please use the URL of your actual server for these exercises.

   
   

2. Confirm there is a valid account to be used for any web service calls available on the target tenant/server.  In this example, on the https://sandboxacme.eccentex.com server we have created a user account for web service calls (to manage security around which solutions can be accessed).  The user login and password for this account is 'webapi':
   
   
   Therefore the username and password for this user account - and what we will use to generate our security token for this example - is username: webapi and password: webapi
   
   

...

1. Log into the tenant containing the solution (i.e. https://sandbox.eccentexacme.com/) with your usual credentials or with credentials that gives you administrator access to the System Setup area of the tenancy:
   
   
   
2. Click on System Setup Home > Environments.  Click on the blue hyperlinked name of your solution:
   
   
   
3. The domain code name can be found in the Domain field as below:
   
   
   
   Therefore our domain name is AppBase_Training_QA.tenant1

...

1. Our first call to the AppBase web service will be to retrieve a security token so that we can retrieve a token for subsequent web service calls.  This involves sending a GET request to the AppBase Security Authentiation REST API that includes the credentials of the user.  The full URL of the call will be:
   
   https://sandbox.eccentexacme.com/Security.WebService/AuthenticationServiceRest.svc/login?u=webapi&p=webapi
   
   
   
   
2. The response you receive should be a long GUID that represents the security token that needs to be included in any subsequent call to the REST API: