Events API guarantees

[rzarajczyk]

Hi, I'm a Java Developer who would like to use Akeneo Events API to integrate my software with on-prem installation of Akeneo 5.

The documentation (https://api.akeneo.com/events-documentation/subscription.html#receive-events) states that Be careful as some events can be sent in the wrong order, more than once, or get lost altogether.

Is it a bug in documentation? I understand that events might be in different order or multiplied - and I' fine with this - but I don't understand this get lost altogether part - does it mean that the API is not realiable? I thought there is a guarantee that every change in a product will be reflected in events at least once.