The question about API changes

Platform API
1

I understand that API changes have the following categories:
・Non-Breaking
・Breaking
・Major API Version Deprecations
・API Resource Deprecations
・Emergency Changes
Among them, will APIs be provided in parallel for Non-Breaking, Breaking, and Major API Version Deprecations in any case?
If so, when will it be offered and how will it be available until release?

2

Hi there. In most cases that we might need to make a breaking change, instead we publish a new API (to include the change) and leave the old API unchanged, but marked as deprecated.

If an API is deprecated, we will not remove it from service until 1) a replacement API has been provided and 2) no customers are using the deprecated API.

We have no plans to version the API at any point in the foreseeable future, but if we did, we would continue to make the current version available until such time that no customers are using it.

We do not create new APIs for non-breaking changes. We simply make the change and announce if warranted.

Thank you!

3

Hi

Thanks for your answer.

a replacement API has been provided

Can you tell me when the replacement API will be provided?

Best Regards,
Bingkai Miao

4

Hi

I want to check the timing when the replacement API comes out.

Best Regards,
Bingkai Miao

6

HI Bingkai. In nearly all cases, the replacement API is released before or at the same time that we mark the old API as deprecated.

7

This topic was automatically closed 31 days after the last reply. New replies are no longer allowed.