# Общая информация

## Основные возможности

* **Управление счетами:** создание, отмена, проверка статуса
* **Управление платежами**: список платежей, привязка платежа к счету
* **Статистика**: получение агрегированных данных по проектам, по периодам, по кошелькам и пр.

## API ключ

* Получить API ключ можно в разделе [Интеграции](https://dash.bitsby.app/integrations/list)
* Область действия ключа: доступ ко всем данным в вашем личном кабинете
* В будущем мы доработаем функционал API и внедрим следующие настройки: область действия ключей, замена/удаление/создание нескольких ключей `в разработке`

## Ограничения

* **На количество запросов**: не более 1 запроса в секунду

## Авторизация запросов

Для авторизации каждого запроса к API в заголовке `Authorization` необходимо передать ваш API ключ.

Пример использования заголовка `Authorization` в запросе к API:

```bash
curl -X POST https://api.bitsby.app/invoices/list \
  -H "Authorization: Token MSvL2ltaDZdWVjmZURURMVWhqSJLT2NURjhL2Fla1Z1T1IxQTltKs1T3Ay"
```

## Ответ сервера

Ответ сервера API всегда приходит в формате JSON. Ориентируйтесь на параметр `result` для определения успешности результата запроса.

Пример ответа сервера в случае положительного результата запроса:

```json
{
    "result": "success",
    "data": .....
}
```

Пример ответа сервера в случае ошибки:

```json
{
    "result": "error",
    "data": "Requests too frequent"
}
```


---

# 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.bitsby.app/ru/dokumentaciya-api/obshaya-informaciya.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.