Developers & AI Agents

Build on Xrossways Solar content

Read-only, no-auth machine interfaces: a static JSON Content API, an OpenAPI 3.1 spec, llms.txt briefs, and Markdown content negotiation on every content page.

Read-only No API key OpenAPI 3.1 RFC 9457 errors

Content API endpoints

GET /api/v1/projects.json

listProjects — Installation case studies: location, system size, savings, specs.
GET /api/v1/blog-posts.json

listBlogPosts — Articles with full markdown content, author, date, tags.
GET /api/v1/subsidies.json

getSubsidyData — PM Surya Ghar tiers plus per-state subsidies and net-metering rules.
GET /api/v1/faqs.json

listFaqs — Categorized solar FAQs with questions and answers.
GET /api/v1/pricing.json

listPricingTiers — Package pricing, subsidy eligibility, net cost, payback specs.
GET /api/v1/quiz.json

getSolutionQuiz — Find-Your-Solution quiz questions and recommendation rules.

Unknown /api/* paths return HTTP 404 with application/problem+json; non-GET methods return 405. Static files carry no enforced rate limits.

Versioning: /api/v1/ is current. Breaking changes ship as a new /api/vN/ path while the previous major stays available; unversioned /api/*.json aliases track the current major for compatibility.

Deprecation policy: a superseded major keeps serving for at least 90 days with Deprecation: true and Sunset: <date> response headers plus a migration note here and in /openapi.json before removal. No version is currently deprecated.

Discovery files

/openapi.json OpenAPI 3.1 spec — Typed schemas + unique operationIds
/llms.txt llms.txt overview — Concise brief incl. when-to-use guidance
/llms-full.txt llms-full.txt — Complete site content in markdown
/sitemap.xml XML sitemap — All indexable URLs with lastmod
/robots.txt robots.txt — AI crawlers explicitly allowed

Read the OpenAPI spec Read llms.txt

Example requests

curl https://xrossways.com/api/v1/projects.json
curl -H "Accept: text/markdown" https://xrossways.com/blog/calculate-solar-roi-for-home/

Any content page (homepage, blog posts, projects, subsidies, FAQs) returns Markdown when requested with Accept: text/markdown, with Vary: Accept and a Link: rel="alternate" pointer on the HTML variant.

Error format

{
  "title": "Not Found",
  "status": 404,
  "code": "api_route_not_found",
  "detail": "No API resource at /api/unknown.",
  "resolution": "Use one of the documented paths in /openapi.json."
}

Contact: contact@xrossways.com · +91 70424 94276