NETIM recommends that your new client applications use the most recent version of the API to fully exploit the benefits of news features and reduce your technical debt over time.
NETIM strives to make backward compatibility as easy as possible when using the SOAP API.
However we do not guarantee that an application written against one SOAP API version will work with future SOAP API versions: Changes in method signatures and data representations are often required as we continue to enhance our APIs. However, we strive to keep our APIs consistent from version to version with minimal, if any, changes required to port applications to newer versions.
NETIM is committed to supporting the current release and the previous one. In order to mature and improve the quality and performance of the API, versions that are two release old might cease to be supported.
Major changes for this version:
- Synchronous execution
Previously, the majority of functions were performed asynchronously. It means that calling a function generates an operation that was put on hold. This operation was subsequently carried out by a process programmed to start at regular intervals on our servers. Thus, it could take several minutes between calling a function and executing the associated operation. With this version 2.0 of our API, the functions will now be executed synchronously. The associated operation will therefore be executed immediately. The result itself can be pending for example with manual registries or if the processing is longer than expected.
This synchronous mode will be enabled by default on each connection to the API. However, it will be possible to return to the asynchronous mode via the sessionSetPreference function.
- Return value of functions generating an operation
Following the synchronous execution, we have modified the return value of the functions generating an operation. Previously, these functions returned only an identification number for the associated operation. Now they will return a StructOperationResponse object that will contain all the useful information about the operation, including its status ( “Cancelled” / “Done” / “Failed” / “Pending” ).
- Managing “additional” contacts values
Another major change is how the “additional” contact information is handled. This is specific information associated with the owner and / or administrative contacts required for the registration of certain extensions. You will find all the necessary information on the descriptive pages of the extensions ( See Extensions informations )
- New functions for managing SSL products
New functions have been added to enable SSL certificate management. It is now possible to create, renew, reissue, revoke and edit the preference of an SSL service.
Minor changes of this version:
- Adding and Modifying Some Functions
domainPriceList is a new function to retrieve the complete price list for each extensions.
queryHostList is a new function to retrieve the list of hosts linked to your account (with the IPv4 and IPv6 associated).
queryResellerAccount has been modified to return more information about your reseller account preference.