Developer documentation
Errors
An error should tell the caller whether the input is invalid, access is denied, state conflicts, a dependency failed, or the outcome is still unknown.
Implementation guide
What the integration should preserve.
- 01
Log the request ID, not secrets or full credentials.
- 02
Fix validation and authorization errors before retrying.
- 03
Treat a state conflict as a reconciliation problem.
- 04
Use Retry-After only where the response explicitly permits it.
- 05
Open support with organization, product, environment, request ID, and timestamp.
Continue reading