Company
Date Published
Author
Anthony Accomazzo
Word count
1956
Language
English
Hacker News points
None

Summary

Anthony Accomazzo discusses the challenges of efficiently detecting changes in APIs, particularly focusing on the limitations of webhooks and the necessity for a robust method of consuming changes, which is a common usage pattern. He critiques webhooks for their delivery issues and lack of support for comprehensive updates, proposing the use of an /events or /updated endpoint as a more reliable solution. The /updated endpoint would allow consumers to paginate through updates using a combination of updatedAfter and afterId parameters, which help avoid record omission or duplication errors common in other pagination designs. Accomazzo suggests this approach would ensure completeness and reliability in tracking changes, enabling consumers to initialize their cursors and replay records easily. He also explores the benefits of using pagination tokens over manual cursor management, although he acknowledges their opacity. Additionally, he proposes a unified /updated endpoint for listing changes across all tables, which could be filtered by record type to suit different consumer needs, and highlights the potential need for a /deleted endpoint to track deletions.