Setting up the Advantage CSP API
Setting up the Advantage CSP Server API for accessing any object can be straightforwardly accomplished by creating an API entry within the configuration section. This setup allows the configuration of the same object under various API names, enabling the provision of distinct authentication levels or workflows to different clients. This flexible approach ensures tailored access and functionality for diverse client needs.
Creation Date: March 21, 2024
Created By: Oren Shapiro
# After logging in, you’re likely to be greeted by the admin dashboard. Look for the primary admin navigation pane, often located on the left side or at the top of the page. Here, find and select the “Configuration” option. Visualize a navigation
1. Click on Domain Management; Expanding Configuration Options:
Upon selecting “Configuration,” a submenu or list of options should appear. Expanding the node reveals additional settings such as “Site,” “Social,” and “System tabs.”
2. Navigating to Configuration:
3. Accessing System Settings:
From the expanded menu options under “Configuration,” click on “System.” This action will change the main admin workspace to display various system settings. You might see a grid or list layout showcasing different system settings.
4. Selecting API Settings:
Within the System settings, look for “API Settings” or a similar term indicating settings related to the Application Programming Interface. There might be an icon or a pencil symbol to edit or view these settings.
5. Adding a New API Entry:
In the API Settings view, there should be an option to add a new API object or entry, often labelled as “Add” or “Create New.” This could be a button or a link. This option will allow you to configure a new API endpoint or access rule.
6. Configuring API Access:
After selecting “Add” to create a new API entry, you’ll have a form or fields to enter the required information for your new API object. This could include specifying the type of object, access permissions, keys, or other relevant details nec
7. Type "the name of your business object"
8. The auto-complete will reveal a dropdown for selection
9. Check Use Cache if applicable
10. Set your cache expiration
11. Select API Security, i.e. Secure read / Secure write from Permissions
12. Click on Update
13. Click on Save

Advantage Server API Security
In order to access BusinessObjects that have been defined as “Secure” in the configuration, an “AdvantageSecureContentControllerHandler” must be defined and added to the “AdvantageCSP.API.WebApiConfig”.
AdvantageSecureContentControllerHandler Implementation
Global.asax Configuration
Advantage Client API
This method will return a list of objects defined as API accessible. Follow the instructions for implementation, including routing and optional security
Advantage Server API Security & Client API
Advantage Client API Wrapper
Advantage CSP offers a client wrapper to simplify retrieving data. Reference the API wrapper JS file from the Advantage server as follows:
The `AdvantageAPI.js` file provides objects to assist in defining method calls. Here's a sample implementation:
POST Get All Objects Example
Below is a basic list request sample for retrieving object "article" for language "en" using a secure method:
POST Get Filtered Objects Example
An advanced list request sample for retrieving "article" for language "en" with filtering: