Install AskiaField REST API
5.4 brings the usage of the AskiaField API. Once installed you can interact with your CCA through JSON
requests.
- Pre-requisites
- Running the setup
- Testing
Pre-requisites
- Askia
- AskiaField 5.4 and above (see installation notes)
- Windows Server Features
- Web Server server (IIS)
- IIS 6 Management Compatibility
- IIS 6 WMI Compatibility
- IIS Management Script and Tools
- IIS 6 Management Compatibility
- Application Server
- .NET Framework 4.5
- Windows Process Activation Service Support
- HTTP Activation
- Web Server server (IIS)
The CcaAPI-Setup v5.4.x.x.exe contains two setups: the one for the CCAAPI itself, and the one for CCAWebAPI. The CCAAPI setup is the mandatory link with the CCA.
- The CCAAPI Web service is used, for now, by CCAWebAPI and CCAPortal.
- The CCAWebAPI is the Web service used to pilot the CCA (with JSON requests).
Running the setup
After unblocking the setup file, run it locally with Administrator privileges. You will be prompted with the following sequence of setup screens.
Here select the setup you want to perform (by default both are selected):
A quick detection for the minimum hardware requirements is made:
Select the website where you want to install the CCAAPI service. The "Create a New Application" option is automatically set:
The "Create a new application pool" is automatically set:
Enter the internal IP Address of the CCA:
And the external one:
Once the CCAAPI setup is installed, it will automatically start the CCAWebAPI setup. Again, you will find the same kind of settings as CCAAPI setup:
Enter the IP Address to the CCAAPI service (internal or external IP)
Last screen > Check the "open CCAWebAPI" to verify that the service is installed correctly: http://[ServerName]/CcaWebApi
Back to CCAAPI setup:
You can test if the service is correctly installed by checking the "Open CCA API". That will open a browser with the default address: http://[ServerName]/CcaAPI/CcaAPI.Service.svc
Testing
To test if the installation was successful, navigate to the following addresses
- http://[ServerName]/CcaWebApi
- http://[ServerName]/CcaAPI/CcaAPI.Service.svc