# Introduction

### Welcome to the VAKA Online API :slight\_smile:

The VAKA Online API allows you as an integrator to manage different aspects of a VAKA system, giving you all the possibilities to extend your solution with VAKA access control features and beyond.

### General API Concepts

#### Event-Driven

The VAKA Online API is event-driven by design to provide a modern and scalable experience with high performance in mind, supporting the following patterns:

* Fetching required data (for example doors) from the API, allowing you to intially collect the current state and establish a baseline.
* Subscription on changes, where events is published to registered webhooks to signal state changes. This differs from a traditional and usually exhaustive "polling" approach - instead things are pushed to you when necessary.

**Asynchronous Request-Response Pattern**

* Requested operations through the API is typically accepted (returning 202 Accepted) and queued for execution as soon as possible, leaving you offloaded to continue with other things.
* Once the requested operation is completed, the result is delivered to you as webhook event.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.vakaonline.se/getting-started/introduction.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.