Shopify Admin API

Shopify Admin API — это инструмент с полным доступом на чтение и запись к REST API Shopify для управления заказами, товарами, клиентами, инвентарем, выполнением заказов, возвратами, транзакциями и другими сущностями магазина.

Описание

Данный API предоставляет разработчикам возможность напрямую взаимодействовать с административной частью Shopify и автоматизировать ключевые бизнес-процессы. С его помощью можно создавать, обновлять и удалять данные магазина, а также получать подробную аналитику и управлять операциями в реальном времени.

Настройка

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

Каждый запрос к API требует передачи заголовка:

X-Shopify-Access-Token: $SHOPIFY_ACCESS_TOKEN

Получение токена доступа

• Перейдите в Shopify Admin → Settings → Apps and sales channels
• Нажмите «Develop apps» → «Create an app»
• Настройте необходимые права доступа (scopes)
• Установите приложение в магазин
• Скопируйте Admin API access token

Базовый URL API

https://$SHOPIFY_STORE_DOMAIN/admin/api/2024-10

Работа с заказами (Orders)

Получить список заказов

GET /orders.json

Доступны параметры фильтрации: ids, limit, status, created_at_min/max, financial_status и другие.

Получить заказ

GET /orders/{ORDER_ID}.json

Обновить заказ

PUT /orders/{ORDER_ID}.json

Можно изменить заметки, теги и другие параметры заказа.

Отмена заказа

Поддерживаются причины: customer, fraud, inventory, declined, other.

Работа с товарами (Products)

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

GET /products.json

Создание товара

POST /products.json

Можно указать название, описание, поставщика, тип товара, статус и варианты.

Обновление и удаление

Поддерживаются операции обновления и удаления товаров по ID.

Варианты товаров (Variants)

• Получение списка вариантов
• Создание варианта
• Обновление цены и параметров
• Удаление варианта

Клиенты (Customers)

• Получение списка клиентов
• Поиск по email, имени, телефону
• Создание и обновление профиля клиента
• Удаление клиента
• Получение заказов клиента

Инвентарь (Inventory)

• Просмотр остатков
• Изменение количества
• Установка фиксированного значения
• Привязка к локации

Локации (Locations)

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

Фулфилмент (Fulfillments)

• Получение данных по доставке
• Создание фулфилмента
• Обновление трекинга
• Отмена выполнения заказа

Возвраты (Refunds)

Можно рассчитывать возвраты и управлять возвратами по заказам, включая повторное размещение товаров на складе.

Транзакции (Transactions)

• Просмотр транзакций заказа
• Создание списания (capture)
• Возвраты и отмены

Коллекции (Collections)

• Работа с пользовательскими коллекциями
• Создание и обновление
• Удаление
• Получение smart-коллекций

Заключение

Shopify Admin API — мощный инструмент для автоматизации управления интернет-магазином. Он позволяет интегрировать внешние сервисы, строить кастомные решения и полностью контролировать бизнес-процессы без необходимости ручной работы в админке.