🌐 Руководство по использованию API сайта — для пользователей

💡 Вы — покупатель. Мы — ваша платформа.
Вам не нужно знать, как работает API.
Мы сделали всё, чтобы вы могли просто выбирать, покупать и получать товары — без лишних сложностей.

✅ 1. Как получить доступ к API

🔐 Вам нужен токен авторизации

Все запросы к API должны содержать токен доступа.
Он подтверждает, что вы — авторизованный пользователь.

📥 Как получить токен?

Отправьте POST-запрос на адрес:
https://cozy-opt/api/v1/token/

Заголовок:
Content-Type: application/json

Тело запроса:

{
  "username": "ваш-email@example.com",
  "password": "ваш-пароль"
}

💡 Важно: В нашей системе авторизация происходит по email, а не по логину.
Используйте именно свой email в поле username.

✅ Ответ сервера:

{
  "token": "abc123xyz789"
}

Этот токен — ваш ключ к API.
Храните его в безопасности.
Он действует бессрочно, пока вы сами не выйдете из системы.

🛡️ Как использовать токен в запросах?

Добавьте его в заголовок каждого запроса:

Authorization: Token abc123xyz789

🔒 Без этого заголовка — доступ запрещён.
Анонимные пользователи не могут ничего делать.

✅ 2. Что вы можете делать — основные возможности

🔹 2.1. Просматривать товары

Вы можете видеть все доступные товары, которые не скрыты администраторами.

✅ Возможности:

• Получить список всех товаров
• Фильтровать по названию, артикулу или месту хранения
• Фильтровать по категории
• Посмотреть детали одного товара

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

GET /api/v1/product/?search=iphone&category_id=5
Authorization: Token abc123xyz789

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

{
  "id": 123,
  "title": "iPhone 15 Pro",
  "article_number": "1001",
  "slug": "iphone-15-pro-1001",
  "category": {
    "id": 5,
    "name": "Смартфоны",
    "slug": "smartfony"
  },
  "sizes_and_prices": [
    {
      "size": "128GB",
      "price": 89990,
    },
    {
      "size": "256GB",
      "price": 99990,
    }
  ],
  "images": [
    "https://ваш-сайт.рф/media/images/iphone15_1.jpg",
    "https://ваш-сайт.рф/media/images/iphone15_2.jpg"
  ]
}

⚠️ Вы не можете создавать, редактировать или удалять товары.
Эти действия доступны только администраторам.

🔹 2.2. Просматривать свои заказы

Вы видите только свои заказы — никаких чужих.

✅ Возможности:

• Получить список всех своих заказов
• Фильтровать по статусу: new, in_progress, delivered, cancelled
• Посмотреть детали одного заказа

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

GET /api/v1/order/?status=new
Authorization: Token abc123xyz789

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

{
  "id": 456,
  "first_name_last_name": "Иван Иванов",
  "email": "ivan@example.com",
  "phone": "+79001234567",
  "address": "г. Москва, ул. Ленина, д. 10",
  "status": "new",
  "delivery_method_title": "Курьерская доставка",
  "price_delivery": 500,
  "get_total_cost": 179980,
  "items": [
    {
      "product_title": "iPhone 15 Pro",
      "product_article": "1001",
      "size_title": "128GB",
      "price": 89990,
      "quantity": 1,
      "product_images": [
        "https://ваш-сайт.рф/media/images/iphone15_1.jpg"
      ],
      "product_total_cost": 89990,
    }
  ]
}

🔒 Вы не видите:

• Кто назначил сборщик (поле assigned_to)
• Внутренние метки склада
• Историю изменений статуса
  Это скрыто для вашей безопасности и конфиденциальности.

❌ Вы не можете менять статус заказа, удалять его или редактировать позиции.

🔹 2.3. Создавать заказы

🛑 Важно:
Создание заказа через API по умолчанию не доступно для пользователей.
Это действие доступно только через обращение в администрацию сайта.

API позволяет только просматривать заказы — не создавать их.
Это сделано для безопасности: все заказы проходят проверку, валидацию и подтверждение через интерфейс сайта.

🔒 Безопасность и конфиденциальность

• Все данные передаются по HTTPS.
• Персональные данные защищены в соответствии с ФЗ-152 «О персональных данных».
• Мы не храним пароли — только хеши.
• Токены не имеют срока действия — но вы можете в любой момент выйти из системы через сайт, чтобы токен стал недействительным.
• Все цены и статусы — снэпшоты. Они не меняются после оформления заказа.

💬 Служба поддержки

Если у вас есть вопросы по:

• оформлению заказа
• доставке
• статусу заказа
• оплате

Напишите нам:
📧 ccozy@yandex.ru
⏰ Работаем: Пн–Пт, 9:00–20:00 (Московское время)

Мы ответим в течение 1–2 рабочих часов.

📎 Для разработчиков — отдельная документация

❌ Эта часть не для пользователей!

Если вы — разработчик и хотите интегрировать API в своё приложение — обратитесь к административной документации по адресу:
👉 https://cozy-opt.ru/api

Там вы найдёте:

• Полный список эндпоинтов
• Примеры запросов и ответов
• Схемы данных
• Инструкции по аутентификации админов
• Доступ к Swagger UI

✅ Заключение

🛒 Вы — покупатель.
Мы — ваша платформа.
API работает за кулисами — чтобы вы могли просто выбирать, покупать и получать товары без лишних сложностей.

Не нужно ничего знать о токенах, заголовках или JSON-ответах.
Всё, что вам нужно — это сайт, ваш email и желание купить.

Спасибо, что выбираете нас.
С уважением,
Команда cozy-opt.ru