Why it matters
Clear API contracts reduce friction across teams. This tool extracts endpoints, methods, params, and basic schemas from traffic captures and commands, then organizes them into a consistent OpenAPI 3.1 document. You can refine the result with human‑readable descriptions and examples, ready for docs or mock servers.
Features
- cURL → OpenAPI 3.1 with smart parsing of flags and payloads.
- HAR → OpenAPI 3.1 with path grouping and response detection.
- Schema hints from observed JSON shape; safe defaults for unknowns.
- Optional component de‑duplication and reusable parameters.
- Export as YAML or JSON, ready for validation and CI.
FAQ
Does it handle authentication headers?
We detect common auth patterns and add placeholder security schemes which you can refine (e.g., bearer, API key).
How accurate are schemas?
We infer conservative JSON Schema based on examples; you can promote types and add formats as needed.
Can I import into Swagger UI or Redoc?
Yes, exports are compatible with common viewers and generators. We recommend linting with spectral or openapi‑validator.
Suggested workflow
- Capture a minimal HAR of representative requests or prepare cURL snippets.
- Generate the baseline spec here.
- Review and enrich descriptions, examples, and error models.
- Commit to your repo and wire CI to validate.