Update 03.06.2021

Dear Partners & Customers

SAP has informed us that the changes to the FSM API described below have been postponed to the 1st of December 2021. 

The original update from SAP in full:

******************************************************

As communicated in February 2021 we introduce changes to SAP FSM APIs (QueryApi and DataApi 4) which restrict pagination capabilities in favour of overall performance and availability of the service.
The change was meant to come into effect from 1st of June 2021, but some of our customers have not yet adjusted to this change which may break their custom integration and/or applications. 

We always strive to protect the user experience of our customers, therefore we postpone enablement the restrictions to the API pagination until 1st of December 2021 allowing more time to adjust to this change. If the change affects your custom integration, service and/or application, you are requested to make the necessary adjustment before the above-mentioned timeline. 

******************************************************

Original post

Dear Partners & Customers

We've received a message from SAP regarding the SAP FSM API and a pagination restriction which will be introduced on 1st of June 2021. Check out the docs regarding this new restriction here.

Following is the complete message from SAP:

******************************************************

This communication is mainly relevant for SAP FSM tenants having a custom developed integration, application or service, which use QueryApi and/or DataApi 4 as well as for partners and developers, which access SAP FSM APIs directly in order to build custom applications and integrations.

No action is needed, in case there is no custom component/integration (which use QueryApi and/or DataApi 4) developed for your SAP FSM tenant.

At this point, there are no restrictions on pagination in Query API and Data API v4 - it is possible to request a page of any size. This may have significant performance implications in the event a very large page is requested.

According to our logs your FSM tenant account has a custom client application, web container and/or integration service, which currently makes API calls requesting pages of large size.

Please be informed that a few non-backwards compatible restrictions will be introduced in QueryApi and DataApi 4 on 1st of November 2020, which potentially affect your custom developed services and integrations.
In essence the following restrictions will apply:

• Maximum page size will be limited to 1000 objects

• Maximum number of objects retrievable via standard pagination will be limited to 100,000 objects

We kindly ask to you to identify all cases where a custom application, web container or integration does API requests with pageSize greater than 1000 objects as well as cases when more than 100,000 objects are retrieved from the API using standard pagination (using page=X&pageSize=Y). Then, depending on the outcome, take one of the following actions:

• If there are less than 1000 results expected to be returned for the API request, the easiest course of action would be to set pageSize to a value of 1000 or less.

• If there are more than 1000 but less than 100,000 results expected to be returned, then iterate using standard pagination mechanism (page=1, page=2, page=3, etc.).

• If there are more than 100,000 results expected to be returned from the API than iterate using keyset pagination .

Also note that SAP FSM tenants created after 24.01.2021 already have the API restrictions enabled.

Further details on upcoming changes and contact information can be found here.

******************************************************

Should you have any questions regarding this change, please contact our support.