Web-hooks — the list of available
- Natalia Chernichko
- Alex Adrianov
Web-hooks allow receiving data about new records in Cartum when events are triggered on the site (e.g. Checkout).
It is convenient to use in order to reduce the load on the server on which the site is located and eliminate the need to make frequent requests for uploading new data (which may not even be updated) from the site, such as:
- Order placement
- User registration
After subscribing to events, the system creates a queue for sending data to the links of event subscribers when the event is triggered. In case if a request for a subscriber link returned an HTTP code other than 20x (200, 201...), then Cartum will try to send data on the subscriber link again after a time (about 10 minutes) (maximum 10 times).
Note
The hook queue is sent by the task scheduler (cron) every 5 minutes, so there may be delays in sending data.
This is done to avoid blocking the user interface when working with the site
If a subscriber is manually deleted in Cartum (available to developers), system will automatically send a DELETE request to the link specified when subscribing to the hook, which will mean that the subscriber is no longer registered in the system.
It is recommended that developers who are developing integration with Cartum add HTTP DELETE method processing to the system.
Table of Contents: