Reference API integration
Before starting
Before starting integration with Passworks REST API we recommend you taking a look a the latest version of the API reference documentation that can be found in GitHub.
And try to figure out the common objects that you can create using the API (assets, passes, etc), how authentication and pagination work.
We recommend you reading the following entries:
Integrating with Passworks REST API
In order to improve resilience when integrating with the Passworks API we recommend that you implement a asynchronous process of integrating with Passworks that allows you to queue requests and increases resilience in case Passworks API takes to much time to answer or sufferers a disruption.
Integrating with Passworks Events / WebHooks
Passes generate events during their lifecycle change, Passworks is able to trigger a HTTS call to a predefined endpoint each time a event is generated.
Because of the nature of how events are generated and the amount of passes that can exists, Passworks can make a huge amount of requests to your system.
Our recommendation is to store all incoming events inside a message queue instead of processing the same directly.
This will give you time to ingest all incoming events without much overhead while giving a way to consume events at the speed that your infrastructure allows you without having to worry about back pressure.
