In some scenarios, it may be necessary to wait for a Book to reach a certain status before you can perform a certain action.
For instance, every Document in a Book must achieve
VERIFICATION_COMPLETEstatus before you can request analytics for the Book. To check if verification status is complete, poll the Book status endpoint.
Use webhooks to receive reliable notifications about document completion.
If setting up a publicly exposed endpoint is not an option, you can poll specific status query endpoints.
Polling checks for an expected condition by calling a particular query endpoint in a loop.
Since the status of endpoints does not change often, invoking the same query endpoint repeatedly is likely to give the same result for most invocations.
A more efficient approach is to poll in larger intervals, preferably with a back-off strategy for error conditions. To view more details about polling strategies, view Retry strategies.
Updated 7 months ago