---
title: Аутентификация
description: API-ключ Levam OEM API — как получить и передавать, форматы ошибок авторизации.
---

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

Все методы Levam OEM API требуют API-ключ. Ключ передаётся **query-параметром `api_key`** в каждом запросе:

```bash
curl "https://api.levam.net/oem/v1/CatalogsListGet?api_key=ВАШ_КЛЮЧ"
```

Заголовки авторизации (Authorization, X-Api-Key и т.п.) не используются.

## Как получить ключ

1. Зарегистрируйтесь на [levam.ru](https://levam.ru/register) (или [levam.net](https://levam.net/register)).
2. API-ключ отображается в [личном кабинете](https://levam.ru/cabinet).
3. Для работы API нужен активный пакет юнитов — см. [Тарификация и биллинг](/docs/ru/billing).

## Ошибки авторизации

| HTTP-статус | Тело ответа | Причина |
|---|---|---|
| 401 | `{"error": "invalid api key"}` | Ключ не передан, не найден или заблокирован |
| 403 | `{"error": "Client disabled. not enough money"}` | Доступ отключён: закончились юниты или истёк срок пакета |

При ошибке авторизации запрос не тарифицируется.

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

- Не публикуйте `api_key` в клиентском коде (браузер, мобильное приложение) — вызывайте API со своего сервера.
- В кабинете можно ограничить список IP-адресов, с которых принимаются запросы с вашим ключом.