Skip to content
Docs

API Overview

HVAKR provides API access for integrating with other tools and automating workflows.

API Capabilities

Section titled “API Capabilities”

What You Can Do

Section titled “What You Can Do”

The HVAKR API allows you to:

  • Create and manage projects
  • Read calculation results
  • Export report data
  • Automate repetitive tasks

Use Cases

Section titled “Use Cases”

Common integrations:

  • Import building data from BIM tools
  • Export results to spreadsheets
  • Integrate with project management
  • Automate batch processing

Getting Started

Section titled “Getting Started”

API Access

Section titled “API Access”

To use the API:

  1. Log in to your HVAKR account
  2. Go to Settings > Access Tokens
  3. Generate an API token
  4. Use the token in API requests

API Documentation

Section titled “API Documentation”

Full API reference available at:

Authentication

Section titled “Authentication”

Access Tokens

Section titled “Access Tokens”

API requests use token authentication:

Authorization: Bearer YOUR_TOKEN

Token Security

Section titled “Token Security”

Keep tokens secure:

  • Don’t share tokens
  • Rotate tokens periodically
  • Use environment variables

Client SDKs

Section titled “Client SDKs”

We provide official client libraries to make integration easier.

Learn more about Client SDKs

TypeScript/JavaScript

Section titled “TypeScript/JavaScript”
Terminal window
npm install @hvakr/client

Python

Section titled “Python”
Terminal window
pip install hvakr

Rate Limits

Section titled “Rate Limits”

Request Limits

Section titled “Request Limits”

API requests are rate-limited:

  • 100 requests per minute
  • 10,000 requests per day

Handling Limits

Section titled “Handling Limits”

When rate limited:

  • Wait for the reset time
  • Implement exponential backoff
  • Contact support for higher limits

Best Practices

Section titled “Best Practices”

Error Handling

Section titled “Error Handling”

Handle API errors gracefully:

  • Check response status codes
  • Parse error messages
  • Implement retry logic

Efficiency

Section titled “Efficiency”

Optimize API usage:

  • Batch requests when possible
  • Cache results locally
  • Only fetch what you need

Support

Section titled “Support”

Getting Help

Section titled “Getting Help”

For API support: