Document rate-limit handling and implement Retry-After headers

When GoCardless (or other providers) rate-limits Lunchflow's API calls, we currently return a 503 with the message "Bank data is temporarily unavailable. This usually resolves within a minute."

Without documented retry semantics, client integrations have no spec to work from. Two concrete asks:

  1. Document in the API docs how clients should handle 503 responses from Lunchflow when upstream rate limits are hit, including recommended retry windows.
  2. Implement a Retry-After header in the response so integrations can handle retries correctly without guessing.

Context: this surfaced because all self-hosted Sure instances default to syncing at 02:22 UTC, creating a thundering herd that hits GoCardless's 100 req/min cap.

Please authenticate to join the conversation.

Upvoters
Status

Planned

Board

πŸ’‘ Feature Request

Date

8 days ago

Author

Stephen

Subscribe to post

Get notified by email when there are changes.