Быстрый старт Customer API: интеграция Accplanet /api/v2 в одном цикле

By Olivia Chen

Август 12, 2026 API 👁 80 views

Если вы покупаете на Accplanet программно, вам не нужен отдельный API для каждого действия. Customer API использует одну конечную точку — POST https://accplanet.com/api/v2 — и параметр action. Это руководство — практическое краткое введение, чтобы разработчик мог за один подход вывести список товаров каталога, проверить остатки, разместить заказ и отслеживать статус.

Accplanet — это маркетплейс-агрегатор поставщиков. Поставщики обеспечивают наличие товаров; Accplanet предоставляет поиск, оформление заказа, отслеживание заказов и поддержку. Используйте API только для легитимного управления заказами. Полная документация: Документация Customer API.

Кратко

Все запросы клиента отправляются на POST /api/v2 (без префикса /en/) с параметрами key/apikey + action.
Типичный путь: balance → categories/shops/services → inventory → add → status.
Отправляйте application/x-www-form-urlencoded или JSON. Никогда не вставляйте ключи в URL или код фронтенда.
Учитывайте available, min/max, баланс кошелька и HTTP 429 / Retry-After.
Держите актуальную документацию открытой во время интеграции — детали полей могут меняться вместе с каталогом.

Авторизация и конечная точка

Создайте или скопируйте ключ клиентского API на странице ключей API в вашем профиле Accplanet, затем вызовите:

POST https://accplanet.com/api/v2

{
  "key": "YOUR_API_KEY",
  "action": "categories"
}

Поддерживаемые действия: categories, shops, services, inventory, add, status, balance.

Схема Customer API: баланс, услуги, остатки, создание заказа, статус — Порядок интеграции, который большинство команд используют для первого успешного цикла покупки.

Этапы интеграции

Переходите к следующему шагу только после того, как текущий вернул корректный ответ.

1 · Сначала

Проверьте баланс

action=balance возвращает баланс кошелька balance и валюту currency (USD). Пополните баланс в панели управления, если его не хватает для тестового заказа.

2 · Рекомендуется

Изучите структуру каталога

action=categories возвращает родительские категории и названия подкатегорий. Используйте эти точные строки позже как фильтры category / subcategory для services.

action=shops выводит список публичных магазинов поставщиков. Передайте ObjectId магазина shop в services, если нужна витрина только одного магазина.

3 · Рекомендуется

Получите список услуг (товаров)

action=services возвращает продаваемые позиции с ID услуги service, ценой rate, остатком stock, доступностью available, минимальным/максимальным количеством min/max и необязательными фильтрами (shop, category, entityType, sort, language, пагинация). Перед заказом предпочтительно выбирать available=true и остаток, соответствующий min.

4 · Рекомендуется

Повторно проверьте остатки

action=inventory с одним ID услуги service или несколькими ID через запятую (максимум 50) подтверждает актуальные остатки. Полезно непосредственно перед add для популярных SKU.

5 · Размещение и отслеживание

Создайте заказ, затем проверяйте статус

action=add с параметрами service и quantity списывает средства с кошелька и возвращает order, charge, currency (HTTP 201). Опрашивайте action=status с этим ID заказа order для отслеживания прогресса и получения данных о выполнении по завершении.

Действие	Задача	Обязательные поля
`balance`	Проверка кошелька	`key`
`categories` / `shops`	Обнаружение	`key`
`services`	Каталог + цены	`key` (+ фильтры необязательно)
`inventory`	Снимок остатков	`key`, `service`
`add`	Создание заказа	`key`, `service`, `quantity`
`status`	Проверка выполнения	`key`, `order`

Готовые curl-примеры

# Баланс
curl -X POST https://accplanet.com/api/v2 -d "key=YOUR_API_KEY" -d "action=balance"

# Страница услуг
curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" -d "action=services" -d "page=1" -d "limit=50"

# Остатки
curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" -d "action=inventory" -d "service=10042"

# Создание заказа
curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" -d "action=add" -d "service=10042" -d "quantity=1"

# Статус
curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" -d "action=status" -d "order=YOUR_ORDER_ID"

Замените плейсхолдеры на ваш ключ, реальный service из services и order, возвращённый add. Начните с количества 1 на недорогом тестовом товаре.

Ошибки и лимиты запросов

Неверные учётные данные → HTTP 401 с {"error":"Invalid API key"}.
Проблемы с валидацией / остатками / балансом → обычно HTTP 400 с одной строкой error (например, недостаточно остатков или средств).
Превышение лимита запросов → HTTP 429 с Retry-After. Сделайте паузу и повторите.
Размер страницы услуг по умолчанию — 50 при пагинации; используйте limit=0 только если намеренно хотите получить полный список.

Цены, остатки и доступность меняются вместе с живыми объявлениями. Всегда перечитывайте services / inventory перед автоматическими покупками.

Чек-лист покупателя

[ ] Ключ API хранится в серверном менеджере секретов
[ ] balance достаточен для небольшого тестового заказа
[ ] Выбрана услуга service с available=true
[ ] Количество в пределах min/max
[ ] Сохранён ID заказа order из add и выполняется опрос status
[ ] В коде обработаны ошибки 429 и ошибки кошелька

Следующий шаг: откройте документацию Customer API, один раз запустите Test API, затем подключите те же действия в свой бэкенд. Поставщикам, интегрирующим синхронизацию каталога, стоит прочитать сопутствующее руководство для поставщиков в блоге Accplanet.

FAQ

Есть ли языковой префикс в пути?

Нет. Используйте https://