Using Webhooks

Synchronous mode

The SDK can be used in a synchronous manner, where each API call completes before the next one is made. This is ideal for simple, one-step-at-a-time tasks where blocking behavior is acceptable. It's easy to use and is perfect for small applications, debugging, or testing.

When to use synchronous mode:

  • For simple tasks that don't require concurrent operations.
  • When you need to perform one API call and get the result immediately, such as uploading a - single video and receiving a playback link.
  • Ideal for smaller applications or developers testing the integration.

Example use case: You want to upload one video of your event’s highlights and immediately get a playback link to share on social media.

Asynchronous mode

The SDK also supports asynchronous operations, leveraging Python's asyncio to allow non-blocking API calls. This makes it perfect for high-performance applications that require parallel API calls, such as handling multiple uploads or streams concurrently.

When to use asynchronous mode:

  • For high-performance, large-scale tasks like bulk video uploads or processing multiple videos concurrently.
  • When you need to integrate with other background services or applications in a non-blocking manner.
  • Ideal for businesses with high-volume video processing needs, like uploading dozens of session recordings from a conference.

Example use case: You need to upload and process multiple videos at the same time, saving time by executing operations in parallel.