intermediate · realtime

The 15-Minute Report

Generating a report takes 15 minutes. How do you design the API for it?

Practical scenario

An analytics endpoint that inlines report generation starts returning 504s from the load balancer once real customer data pushes generation past 60 seconds.

What it tests

  • • Recognizing when request/response stops fitting
  • • The async job pattern: 202, job resource, states
  • • How completion reaches the client