# Access with Swagger

#### Getting started using swagger​ <a href="#getting-started-using-swagger" id="getting-started-using-swagger"></a>

The Integration API can be accessed using our [swagger](https://integration.mapsindoors.com/doc/index.html) frontend. The first thing you want to do is to log in. This is done by pressing Authorize:

<figure><img src="/files/NcToUClxGV2RuJT12TQa" alt=""><figcaption></figcaption></figure>

After this, a confirmation window will be shown. Everything is already prefilled here, so **do not change the `client_id` and `client_secret` input fields — just press Authorize**, and you will be lead to the MapsIndoors authorization service.

<figure><img src="/files/uyfkmjKvjRmYSoH3xXAz" alt=""><figcaption></figcaption></figure>

Once logged in you can start using the Integration API. Each endpoint will grouped by function like "Categories" and "Geodata". Each of these groups offer a number endpoints that allow you to get existing data, create new data, change existing data or delete data. There are examples of each of these for you to look at, but not that this is a read-only sample solution

> ***NOTE:*** ⚠️ The sample solution is read-only. If you replace the APIkey with you own can CAN write to your own data.

We use the four standard HTTP methods to access Mapsindoors data:

* **GET** for getting data. (Marked with blue color)
* **POST** for creating new data (Marked with green color)
* **PUT** for updating existing data (Marked with yellow color)
* **DELETE** for deleting data (Marked with red color)

When you change data (using PUT) you'll need to inform us what what you want to change, so you MUST include an Id. Other than that you only need to mention what you want to change; The rest will stay the same. When creating **new** data (using POST) you´ll need to include ALL data needed for the given object type (but **not** an Id - that will be assigned for you). Otherwise the call will result in a 400 Bad Request (and feedback on what's wrong).

> ***NOTE:*** ⚠️
>
> * The sample solution is read-only. If you replace the APIkey with your own, you can CAN write to your own data.
> * ALL POST and PUT endpoints takes arrays of objects, so even if you only want to change one object you still need to surround it in brackets: "\[ {JSON model} ]"


---

# 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://docs.mapsindoors.com/sdks-and-frameworks/integration-api/integration-api-access/access-with-swagger.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.
