Skip to main content

Gotchas: hbf-core-api

Package-specific non-obvious patterns and pitfalls. Loaded on demand when working on this package.

  • No timeout on requests: hbf-core-api (shared lib) has NO timeout. Requests can hang indefinitely. Set timeout explicitly in every caller.
  • Only retries on network errors: HTTP 5xx responses are NOT retried. Transient 502/503 from upstream restarts cause immediate failure.
  • docs/ is in .gitignore: Must use git add -f docs/<file> to track documentation files in this repo.