Base URLs and versioning
Production hosts, local development and the versioning policy.
| Environment | Base URL |
|---|---|
| Production API | https://api.postvia.dev |
| Local development | http://localhost:8010 |
| Documentation | https://postvia.dev/docs |
| Administration | https://app.postvia.dev |
Versioning
The primary public endpoint is versioned in the path:
/v1/forms/{public_id}/submissions
The /v1 contract is stable. Additive changes such as new optional fields, new examples or new error descriptions are non-breaking. Breaking changes require a new version and a migration note in the changelog.
The short endpoint /f/{public_id} is an alias, not a separate version. It follows the same contract.
OpenAPI
The formal contract is available at:
https://api.postvia.dev/openapi.json
The specification is OpenAPI 3.1 and is generated from the Laravel implementation. Documentation examples are generated from the same source.