# Access and authentication

## Доступ и аутентификация

Ниже приводится обзор того, как получить ключ аутентификации для работы с TradeOn Pulse API, а также информация о версиях и форматах запросов.

***

### Аутентификация

Чтобы воспользоваться TradeOn Pulse API, вам потребуется действующий API-ключ. Его можно сгенерировать и управлять им в личном кабинете на платформе.\
**Никогда не делитесь** своим ключом в открытом доступе — он должен храниться так же надёжно, как пароль.

1. **Где найти ключ**
   * Перейдите в раздел «API Keys» в вашем аккаунте на платформе TradeOn Pulse.
   * При необходимости можно деактивировать ключ и создать новый (например, если он был скомпрометирован).
2. **Как передавать ключ**
   * Добавьте заголовок `Api-Key` к каждому запросу:

     ```
     Api-Key: ВАШ_API_КЛЮЧ
     ```
   * Запросы без корректного ключа будут отклонены (возвращается `Unauthorized`).
3. **Система токенов**
   * Каждый метод API «стоит» определённое число токенов (см. раздел Стоимость методов).
   * Убедитесь, что у вас достаточно токенов для всех необходимых операций.

***

### Формат запросов

* **Базовый URL:**\
  `https://api-pulse.tradeon.space/`
* **Типы контента:**
  * `application/json`
  * `application/x-www-form-urlencoded` (для некоторых эндпоинтов, если требуется)
* **Формат ответов:**
  * Все ответы от API возвращаются в формате JSON.

***

### Версии API

* **Текущая версия:** `v1`\
  Все методы доступны по пути `/public-api/...`.\
  При необходимости внесения несовместимых изменений будет выпущена новая основная версия API.

***

#### Пример запроса

```bash
curl -X GET "https://api-pulse.tradeon.space/public-api/item/base-info?Game=CsGo&Currency=USD" \
  -H "Api-Key: ВАШ_API_КЛЮЧ" \
  -H "Content-Type: application/json"
```

***

### Рекомендации

1. **Храните ключ в секрете**\
   Не публикуйте ключ в репозиториях или на форумах.
2. **Следите за расходом токенов**\
   Контролируйте баланс токенов, чтобы не столкнуться с отказом в обслуживании.
3. **Ротация ключей**\
   При возникновении подозрения на компрометацию ключа — отзывайте его и создавайте новый.
4. **Следите за обновлениями**\
   Ознакомьтесь с релиз-нотами, чтобы вовремя узнавать о новых возможностях или изменениях в API.


---

# 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://tradeon.gitbook.io/tradeon-api/getting-started/quickstart.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.