Что это
Shopify Admin API - интерфейс управления данными магазина из приложения. Через него интеграция может читать товары и заказы, работать с дополнительными полями и выполнять разрешенные изменения. GraphQL позволяет запрашивать только нужные поля вместо полной выгрузки.
Это не готовый AI-продавец. Для генерации описаний или разбора обращений нужна отдельная модель и серверная логика. Права приложения определяют, какие сведения оно действительно может получить и изменить.
Для новых проектов выбирайте GraphQL Admin API: REST Admin API имеет статус legacy. Настраивайте приложение в Dev Dashboard или через Shopify CLI. Старые инструкции о создании нового admin custom app и бессрочном токене не подходят для любого нового подключения.
Ключевые параметры
- Категория: Операционные задачи
- Сложность: Для разработчика
- Запуск: Проектное внедрение
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- GraphQL позволяет выбирать нужные поля товара или заказа.
- Scopes ограничивают доступ приложения по типам данных.
- Версионирование помогает планировать совместимость интеграции.
- Cursor-пагинация позволяет получать каталог частями.
Ограничения
- Требуются приложение, установка и корректный поток авторизации.
- Состав доступных заказов и персональных данных ограничен отдельными правилами.
- Частота запросов зависит от их стоимости и тарифа, а не только числа вызовов.
- HTTP 200 может содержать GraphQL errors: одного статуса недостаточно.
Как использовать
1. Подготовка. Создайте отдельный development store с несколькими учебными товарами. В Dev Dashboard создайте приложение, задайте только read_products и установите его в этот магазин. Не начинайте с реального каталога клиента.
2. Настройка. Для приложения и магазина одной Shopify organization используйте client credentials grant: обменяйте Client ID и Client secret на access token на /admin/oauth/access_token. Для магазина другой организации нужен подходящий OAuth-процесс, а не этот grant. Токен передавайте в X-Shopify-Access-Token и обновляйте до истечения срока.
3. Первый результат. Отправьте POST на https://<shop>.myshopify.com/admin/api/2026-10/graphql.json с Content-Type: application/json и JSON-телом {"query":"query { products(first: 3) { nodes { id title status } pageInfo { hasNextPage endCursor } } }"}. Выведите id, title и status учебных товаров.
4. Проверка. Сверьте результат с каталогом development store, проверьте errors и наличие ожидаемого data. hasNextPage означает, что это не полный каталог: для следующей страницы используйте after с endCursor. Перед массовой выгрузкой проверьте лимиты; перед изменениями - отдельные права, ошибки mutation и план отката.
Примеры сценариев
- Выгрузить названия и статусы учебных товаров.
- Подготовить список карточек для редакторской проверки.
- Связать разрешенные данные заказов с внутренним отчетом.
Доступ и оплата
- Модель оплаты: Платно
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
API применяется в рамках магазина Shopify; стоимость рабочего магазина и приложений учитывается отдельно. Development store не равен бесплатному рабочему магазину. Доступ и оплата из России здесь не подтверждены.
Когда не подходит
- Подключить магазин без установки и разрешения приложения
- Получить готовую LLM через API магазина
- Выдать write-права для первой читающей проверки
Альтернативы
WooCommerce REST API подходит магазину WooCommerce, RetailCRM API - CRM-процессам. Shopify Inventory API на этой площадке выделен в отдельную карточку для учета остатков, но относится к тому же GraphQL Admin API.
