API Документация

Руководство по интеграции MetaLib Shop API для ресейлеров

Начало работы

1. Получение API ключа

Перейдите в раздел API Ключи в вашем профиле и создайте новый ключ с нужными разрешениями.

2. Аутентификация

Все запросы к API должны содержать заголовок с вашим API ключом:

x-api-key: mk_your_api_key_here

# или

Authorization: Bearer mk_your_api_key_here

3. Base URL

https://metalib-shop.com/api/v1

4. Rate Limits

API имеет ограничения по количеству запросов:

100 запросов в минуту для чтения данных
20 запросов в минуту для создания заказов

5. Коды ответов

200 - Успешный запрос
201 - Ресурс создан
400 - Ошибка в запросе
401 - Неверный API ключ
403 - Недостаточно прав
404 - Ресурс не найден
500 - Ошибка сервера

Endpoints

GET/api/v1/products

Список товаров

Получить список всех доступных товаров с пагинацией

Требуемое разрешение

products:read

Параметры

categorystring

Фильтр по slug категории

limitnumber

Количество товаров (1-100, по умолчанию 50)

offsetnumber

Смещение для пагинации

activeboolean

Фильтр по активности (по умолчанию true)

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

curl -X GET "https://metalib-shop.com/api/v1/products?limit=10&category=games" \
  -H "x-api-key: mk_your_api_key_here"

Пример ответа

{
  "success": true,
  "data": [
    {
      "id": "abc123",
      "name": "Grand Theft Auto V",
      "description": "Игра...",
      "price": 1299.99,
      "image": "https://...",
      "stock": 100,
      "isActive": true,
      "category": {
        "id": "cat123",
        "name": "Игры",
        "slug": "games"
      }
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "total": 50,
    "hasMore": true
  }
}

Нужна помощь?

Если у вас возникли вопросы по работе с API, обращайтесь в нашу поддержку:

Связаться с поддержкой