API Lifecycle Governance
API Versioning & Deprecation Policy
Host: dehradun1.vercel.app · Current Active Version: v1
1. Versioning Strategy
The Dehradun Tourism REST API enforces strict URI Path Versioning (e.g., /api/v1/*). All breaking architectural changes will result in an incremented major version prefix (/api/v2/). Non-breaking additive changes (such as new fields or optional query filters) are rolled out within the active version without modifying existing contracts.
Active Stable Version: /api/v1 (Supported indefinitely)
Current Release: 1.0.0
OpenAPI 3.1.0 Spec: /openapi.json
2. Deprecation Notice & Guarantee
To ensure zero disruption for autonomous AI agents, LLM integrations, and developer applications, we guarantee:
- Minimum 12 Months Notice: No API version or endpoint will be sunset without at least 12 calendar months of advance notice.
- No Silent Breaks: Any deprecated endpoint remains functional and reachable until the published Sunset date.
- Machine-Readable Headers: Deprecation notices are broadcast in every HTTP response via standard RFC headers.
3. HTTP Response Headers for Deprecation
Clients and AI agents can automatically detect deprecation state by inspecting standard HTTP headers:
| Header | Example Value | Description |
|---|---|---|
| Deprecation | false / @1924991999 | Indicates whether the endpoint is deprecated, or timestamp of deprecation. |
| Sunset | Wed, 31 Dec 2030 23:59:59 GMT | Exact RFC 7231 date/time when the version will be decommissioned. |
| Link | <https://dehradun1.vercel.app/deprecation>; rel="deprecation" | URL linking directly to this deprecation and migration documentation. |
| API-Version | 1.0.0 | Current deployed API semantic version. |
4. Machine-Readable Policy Endpoint
AI agents can query the machine-readable deprecation policy endpoint at GET /api/v1/deprecation:
{
"api_version": "1.0.0",
"active_version": "v1",
"status": "supported",
"sunset_date": "2030-12-31T23:59:59.000Z",
"deprecation_policy": {
"timeline_notice_months": 12,
"policy_url": "https://dehradun1.vercel.app/deprecation",
"signals": ["Sunset header", "Deprecation header", "Link header"]
}
}