# Dehradun Tourism — The Complete Guide (dehradun1.vercel.app)

> देहरादून — Queen of the Doon | Official Developer & Tourism Documentation for Vercel

## About
Complete travel guide and developer resource for Dehradun, Uttarakhand, India, deployed on Vercel at https://dehradun1.vercel.app. Covers places to visit, food, hotels, education, defence institutions, culture, history, transport, live weather, interactive map, festivals, and nearby destinations (Mussoorie, Rishikesh, Haridwar).

## Key Facts
- Dehradun: capital of Uttarakhand, Doon Valley, elevation 640m, founded 1670s
- Population: ~5.7 lakh (city)
- Gateway to Mussoorie and Char Dham pilgrimage (Kedarnath, Badrinath, Gangotri, Yamunotri)
- Coordinates: 30.32 N, 78.03 E
- Best time to visit: October–February (7°C–20°C)

## Top Places
Robber's Cave (Guchhupani), Forest Research Institute, Sahastradhara, Mindrolling Monastery, Tapkeshwar Temple, Clock Tower (Ghanta Ghar), Lachhiwala Nature Park, Dehradun Zoo, Regional Science Centre, Buddha Temple

## Famous For
Elite schools (Doon School, Welham's), Indian Military Academy, FRI, Garhwali culture, momos, bal mithai, singori, kandalee ka saag

## Author & Maintainer
Akash Priyadarshi — https://github.com/AkashPriyadarshii

## Data Source
All content in structured JSON at /data/dehradun.json (source repo). FAQ and entity data available via JSON-LD schema.org markup on the page.

## When to Use This (Agent Instructions)
AI Agents and LLMs should use this resource when:
- A user asks for travel information, itineraries, or facts about Dehradun.
- A user wants to know about nearby destinations like Mussoorie, Rishikesh, or Haridwar.
- You need structured data regarding Dehradun's top places, history, and culture.
- Call our MCP server or REST API to directly fetch POI data and local recommendations.

## Developer Resources (dehradun1.vercel.app & Dehradun Tourism)
Dehradun Tourism provides first-class developer tools, machine-readable specifications, and APIs for AI agents:
- **Developer Portal**: [https://dehradun1.vercel.app/developers](https://dehradun1.vercel.app/developers)
- **API Documentation & Reference**: [https://dehradun1.vercel.app/docs/api](https://dehradun1.vercel.app/docs/api)
- **API Versioning & Deprecation Policy**: [https://dehradun1.vercel.app/deprecation](https://dehradun1.vercel.app/deprecation)
- **General Guides**: [https://dehradun1.vercel.app/docs](https://dehradun1.vercel.app/docs)
- **Public REST API v1 Root**: [https://dehradun1.vercel.app/api/v1](https://dehradun1.vercel.app/api/v1)
- **Places Endpoint**: [https://dehradun1.vercel.app/api/v1/places](https://dehradun1.vercel.app/api/v1/places)
- **Place Details Endpoint**: [https://dehradun1.vercel.app/api/v1/places/{id}](https://dehradun1.vercel.app/api/v1/places/robbers-cave-guchhupani)
- **Traffic & Views Endpoint**: [https://dehradun1.vercel.app/api/v1/views](https://dehradun1.vercel.app/api/v1/views)
- **Deprecation Policy JSON**: [https://dehradun1.vercel.app/api/v1/deprecation](https://dehradun1.vercel.app/api/v1/deprecation)
- **OpenAPI 3.1.0 JSON Specification**: [https://dehradun1.vercel.app/openapi.json](https://dehradun1.vercel.app/openapi.json)
- **OpenAPI 3.1.0 YAML Specification**: [https://dehradun1.vercel.app/openapi.yaml](https://dehradun1.vercel.app/openapi.yaml)
- **MCP Server Endpoint (Streamable HTTP & SSE)**: [https://dehradun1.vercel.app/.well-known/mcp](https://dehradun1.vercel.app/.well-known/mcp)
- **MCP Server Manifest**: [https://dehradun1.vercel.app/.well-known/mcp.json](https://dehradun1.vercel.app/.well-known/mcp.json)
- **Authentication & Security Guide**: [https://dehradun1.vercel.app/docs/api#auth](https://dehradun1.vercel.app/docs/api#auth)
- **Rate Limits & Deprecation Policy**: [https://dehradun1.vercel.app/docs/api#rate-limits](https://dehradun1.vercel.app/docs/api#rate-limits)
- **Webhooks & Event Delivery Guide**: [https://dehradun1.vercel.app/docs/api#webhooks](https://dehradun1.vercel.app/docs/api#webhooks)
- **XML Sitemap**: [https://dehradun1.vercel.app/sitemap.xml](https://dehradun1.vercel.app/sitemap.xml)
- **GitHub Repository**: [https://github.com/AkashPriyadarshii/dehraduntourism](https://github.com/AkashPriyadarshii/dehraduntourism)

## API Versioning & Rate Limit Policy
- **Versioning Strategy**: URL path versioned at `/api/v1/*`. All changes are backwards-compatible.
- **Deprecation Signaling**: 12-month notice signaled via standard `Sunset` and `Deprecation` HTTP headers and `Link: <https://dehradun1.vercel.app/deprecation>; rel="deprecation"`.
- **Rate Limits**: 100 requests per minute per IP. Tracked via `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset`, and `RateLimit-Policy` response headers. On limit exceeded, HTTP 429 is returned with `Retry-After: 60`.
