Common pitfalls
Every bug in this list happened on a real schema during validation. Patterns to avoid:
- Wrong
expect_status—200vs201vs204mismatches - Cross-actor session-var reference —
{{employer.org_id}}when employer isn’t authenticated - Missing OTP / CSRF prerequisite — auth chains that need a setup step
- Hallucinated body fields — fields the backend rejects
- Hardcoded unique value — works once, fails on re-run
- Wrong JSONPath for extraction — schema vs response shape mismatch
- Mixed
body:andbody_form:— only one per operation - Trailing slash mismatch — backends are strict
baseUrlincludes the version — leads to doubled paths- Unquoted YAML scalars —
otp: 123456parses as int
The full list with concrete fixes is in the authoring guide §Common pitfalls.