# Overview

## Server Side Integration

Atollon provides developers with either full access to server functions using **Web Services** based on **SOAP API** or simplified access using **REST API** for typical integration tasks.

### SOAP API

Any web service is described using **WSDL**. Each of the WSDL files is available at **Host** location, including CSS formatted version for human reading. Simply enter Host URL with the name of the WSDL file into browser and you may get overview about the functions supported.

Atollon provides access to almost all functions supported by the solution using Web Services.

### REST API

For the most common integration tasks, ATOLLON provides also REST API that makes external developer's life easier by hiding some of the internal complexities of platform (that are still accessible by SOAP API).

Documentation to ATOLLON's REST API functions is available on pages of this wiki dedicated to [CRAWLER](https://help.atollon.com/books/atollon-api/page/crawler-import-service "Crawler Import Service").

### Example Connect

Try to access testing sandbox at our vulcano.atollon.com server.

Use **QuickLogin** function based on definition at [https://river.atollon.com/main.wsdl](https://river.atollon.com/main.wsdl "https://river.atollon.com/main.wsdl")

##### Parameters

```
URI: https://river.atollon.com/soap
server: ask us
password: hash5
user: ask us
```

##### Demo Credentials

Server:  
User:  
Pass:

#### md5 hash

You can generate your own password md5 hash using:

```
echo -n "password" | md5sum
```

API Use Cases

You are free to develop any business application / client portal on top of Atollon Server Platform. Applications being developed on top of ASP include usually web integrations of any kind (Web Leads forms, Applicant tracking forms, Projects reporting, client portal, sales automation functions, etc.). The same API is used for Atollon's core products.

#### Examples

[Atollon Web Leads](mks://localhost/en/devel/API/Application_Examples/Atollon_Web_Leads "en/devel/API/Atollon Web Leads")

### Atollon Web Services

- API design principles: [API principles](mks://localhost/Internal/Development/Server/WSDL/SOAP_API_design_principles "SOAP API design principles")
- WSDL listing: [<u>Atollon WSDL files</u>](mks://localhost/en/devel/API/WSDL_listing "en/devel/API/WSDL listing")
- Request examples: [<u>WSDL requests</u>](mks://localhost/en/devel/API/Functions_Examples "en/devel/API/Examples")
- Response exceptions: [<u>Exception listing</u>](mks://localhost/en/devel/API/Web_Service_Exception_Listing "en/devel/API/Possible web service exception listing")

### Web Services Startup

- Request should be encapsulated as text/xml (not text/plain)
- Use [SOAP UI](http://www.soapui.org/) for testing request/response - [<u>basic usage</u>](mks://localhost/en/devel/integration/Basic_usage_of_SoapUI_in_Atollon_enviroment "en/devel/integration/Atollon Web services documentation/Basic usage of SoapUI in Atollon enviroment")
- Use [Wireshark](http://www.wireshark.org/) to monitor communication client/server