API Basics

This section covers basic API concepts at a high level. Once mastered, the Samples Overview section adds more to the story with more details in context. Finally, the CorrigoService API (SOAP) section provides comprehensive details for the programmer.

Before attempting to retrieve or transact data, client applications must authenticate themselves to the Corrigo application and establish a valid integration session. All sessions are managed via HTTP Cookies. You must enable cookies in your development environment to use Corrigo web services.

Creating a Reference to the Service

Include a Web Service Reference in your VS project to the version-specific service URL for your own database--that you received from the Service URL chapter in the Reference section. In Solution Explorer right-click on the References element of the solution tree and select Add Service Reference. Click on Advanced. Click on Add Web Reference. Paste your URL, hit the little right arrow and give it a meaningful name, like ENTERPRISE.
Make sure to include a using yourProjectNameSpace.ENTERPRISE directive in all classes that will require of CorrigoService.

using myProjectNameSpace.ENTERPRISE;

Calling Corrigo Web Service

Create an instance of the CorrigoService class.

CorrigoService corrigoService = new CorrigoService();

Create a cookie container, since the Corrigo web service is Stateful.

corrigoService.CookieContainer = new System.Net.CookieContainer();

Next Step: URL Discovery