Search the Aria Knowledgebase for
User Documentation, APIs, SDKs, and more!



 

Home > Aria6 User Documentation > Aria6 APIs

Aria6 APIs

Overview

Aria provides a comprehensive suite of APIs, grouped into logical categories, based on their method. All Aria APIs can be found on Developer Central under the Aria6 API List.

Aria6 API List.png

API Categories

Core API

The "Core API" category contains APIs that are generally used to work with accounts, account transactions, configuration, and billing interactions.

The supported formats for calling the Core APIs are:

  • application/x-www-form-urlencoded;  
  • REST (application/x-www-form-urlencoded); and 
  • SOAP.

Object Query API

The "Object Query API" category contains APIs that are used to query and get multi-row feedback across accounts, or to extract client product catalog or marketing information.

The supported formats for calling the Object Query APIs are:

  • application/x-www-form-urlencoded; and
  • SOAP.

Admintools API

The "Admintools API" category contains APIs that deal with managing a client's product catalog and marketing activities including the ability to create, modify, and delete objects.

The supported format for calling the Admintools APIs is application/x-www-form-urlencoded.

Making API Calls

Each API request is authenticated using a combination of the <client_no> and <auth_key> parameters.

Special Note for Aria Multi-Tenant Customers

The Aria environment is built to scale horizontally providing the flexibility to handle the ever changing demands of our client base. In our multi-tenant environments, there are inherent limitations in place that are required to keep the database stable. These limits are tuned as our clients provide capacity growth projections through-out a given year. We ask our multi-tenant clients to control how many concurrent APIs are sent to ensure stability of the database. As a guide, we suggest 15-20 concurrent calls across all APIs within your instance. If your business needs require a higher number, we ask that this information is communicated through a support ticket prior to executing, or consult with Aria Professional Services. This level of notification will allow Aria to plan for the additional load, and not disrupt the activities of the other clients within this multi-tenant environment. 

Updating API Changes with New Product Releases

Aria maintains backward compatibility with older versions of the WSDL files (SOAP). However, you do not need to update your REST requests to align with each Aria release since previous API versions continue to function.

  • If you are using SOAP for your Core or Object Query API calls, WSDL files are updated with each release and are included in the release notes.  
  • If you are using REST, any API changes within an Aria release are immediately usable, though not required. 

Endpoint URLs 

An endpoint URL is the URL that is used in the request to call the Aria API web services. In a given environment, the Core API, Object Query API, and Admintools API each have their own endpoint URL.

Below is a list of endpoint URLs for Aria's server environments to be used within your custom code that calls Aria APIs, and they must be tested in the context of code that calls Aria APIs. They are not valid as standalone web addresses and, when called without API data (e.g. pasted into a Web browser's address bar), will result in an error.

Note: The endpoint URLs are also specified near the end of each WSDL file in the <soap:address> element.  

Environment API Category Endpoint URL
Stage Future PHL Core API
https://secure.future.stage.ariasystems.net/api/ws/api_ws_class_dispatcher.php
Object Query API
https://secure.future.stage.ariasystems.net/api/AriaQuery/objects.php
Admintools API
https://admintools.future.stage.ariasystems.net/AdminTools.php/Dispatcher
Stage Future AUS Core API
https://secure.future.stage.aus.ariasystems.net/api/ws/api_ws_class_dispatcher.php
Object Query API
https://secure.future.stage.aus.ariasystems.net/api/AriaQuery/objects.php
Admintools API
https://admintools.future.stage.aus.ariasystems.net/AdminTools.php/Dispatcher
Stage Future EUR Core API
https://secure.future.stage.cph.ariasystems.net/api/ws/api_ws_class_dispatcher.php
Object Query API
https://secure.future.stage.cph.ariasystems.net/api/AriaQuery/objects.php
Admintools API
https://admintools.future.stage.cph.ariasystems.net/AdminTools.php/Dispatcher
Stage Current PHL Core API
https://secure.current.stage.ariasystems.net/api/ws/api_ws_class_dispatcher.php
Object Query API
https://secure.current.stage.ariasystems.net/api/AriaQuery/objects.php
Admintools API
https://admintools.current.stage.ariasystems.net/AdminTools.php/Dispatcher
Stage Current AUS Core API
https://secure.current.stage.aus.ariasystems.net/api/ws/api_ws_class_dispatcher.php
Object Query API
https://secure.current.stage.aus.ariasystems.net/api/AriaQuery/objects.php
Admintools API
https://admintools.current.stage.aus.ariasystems.net/AdminTools.php/Dispatcher
Stage Current EUR Core API
https://secure.current.stage.cph.ariasystems.net/api/ws/api_ws_class_dispatcher.php
Object Query API
https://secure.current.stage.cph.ariasystems.net/api/AriaQuery/objects.php
Admintools API
https://admintools.current.stage.cph.ariasystems.net/AdminTools.php/Dispatcher
Production Core API
https://secure.ariasystems.net/api/ws/api_ws_class_dispatcher.php
Object Query API
https://secure.ariasystems.net/api/AriaQuery/objects.php
Admintools API
https://admintools.ariasystems.net/AdminTools.php/Dispatcher
Production AUS Core API
https://secure.prod.aus.ariasystems.net/api/ws/api_ws_class_dispatcher.php
Object Query API
https://secure.prod.aus.ariasystems.net/api/AriaQuery/objects.php
Admintools API
https://admintools.prod.aus.ariasystems.net/AdminTools.php/Dispatcher
Production EU Core API
https://secure.prod.cph.ariasystems.net/api/ws/api_ws_class_dispatcher.php
Object Query API
https://secure.prod.cph.ariasystems.net/api/AriaQuery/objects.php
Admintools API
https://admintools.prod.cph.ariasystems.net/AdminTools.php/Dispatcher

 

Last modified

Tags

This page has no custom tags.

Classifications

This page has no classifications.