Быстрый старт с Accplanet Customer API: список, проверка наличия и размещение заказов

By Olivia Chen

Сентябрь 13, 2026 Buyer Tips 👁 157 представления

Accplanet Customer API API key api design principles POST /api/v2 reseller API integration check stock API place order API Accplanet services API

Accplanet Customer API quick start

Get an API key and call POST /api/v2 to list services, check inventory, place an order, and poll status.

Create an API key
Open Profile → API key on Accplanet, generate a key, and store it in a secret environment variable.
List services and check stock
POST https://accplanet.com/api/v2 with action=services (cache results), then action=inventory for target service IDs.
Place order and poll status
POST action=add with service and quantity, then poll action=status with the returned order id. Honor HTTP 429 Retry-After.

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

Accplanet — это маркетплейс поставщиков. Customer API предназначен для покупателей и реселлеров, у которых уже есть баланс. Полные таблицы параметров находятся в документации Customer API; этот пост посвящён самому короткому рабочему пути.

Кратко

Создайте API-ключ в своём профиле Accplanet и храните его как пароль.
Вызывайте POST https://accplanet.com/api/v2 с key + action (поля формы или JSON).
Типичный цикл реселлера: services → inventory → add → status (опционально balance).
Кэшируйте чтение каталога. Воспринимайте HTTP 429 + Retry-After как обязательный backoff, а не как необязательную подсказку.
Используйте этот пост для быстрой интеграции; используйте официальную документацию для каждого поля.

Получите свой API-ключ

Войдите, откройте Профиль → API-ключ и сгенерируйте API-ключ. Скопируйте его один раз в менеджер секретов или переменную окружения (например, ACCPLANET_API_KEY). Каждый вызов Customer API аутентифицируется этим ключом в теле запроса как key (псевдоним apikey).

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

Вы также можете отправлять поля в формате form-encoded с помощью curl -d. Предпочитайте переменные окружения жёстко заданным строкам.

Принципы дизайна API (почему одна конечная точка)

Customer API от Accplanet следует нескольким практическим принципам дизайна API, которые упрощают интеграцию реселлера:

Единая точка входа: один URL, множество значений action — меньше базовых URL для настройки.
Явная аутентификация: API-ключ передаётся с каждым запросом; для скриптов не требуется непрозрачный сессионный cookie.
Словарь действий: services, inventory, add, status, balance и связанные действия чётко соответствуют цепочке каталог → наличие → заказ → опрос.
Стабильная структура ошибок: неудачные вызовы возвращают структурированные ошибки; лимиты запросов используют HTTP 429.

Именно поэтому минимальный клиент часто представляет собой тонкую обёртку: задать ключ, выбрать действие, разобрать JSON.

Лестница интеграции

1 · Проверка

Список категорий

Убедитесь, что ключ работает, прежде чем подключать логику заказов.

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=categories"

2 · Каталог

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

Используйте action=services для Accplanet services API / синхронизации каталога. Предпочитайте больший limit (до 500) и кэшируйте ответ локально как минимум на 60–120 секунд. Именно на этом действии реселлеры впервые упираются в лимиты запросов.

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "limit=100"

3 · Наличие

Проверьте наличие перед добавлением

Для пути check stock API вызывайте action=inventory с интересующими вас ID услуг. Пропускайте слепые вызовы add, когда наличие уже равно нулю в вашем кэше.

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=inventory" \
  -d "services=10042"

4 · Заказ

Оформите заказ, затем опрашивайте статус

Place order API: action=add с service и опциональными quantity / link. Затем опрашивайте с помощью action=status и возвращённого ID заказа. Не опрашивайте статус каждую секунду.

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=ORDER_ID"

Лимиты запросов, которые ломают первые интеграции

Аутентифицированный трафик Customer API ограничен квотами на всплеск, глобальными и по действиям. Практические правила для интеграции реселлера с API:

Кэшируйте services; обновляйте по расписанию (часто 2–5 минут), а не при каждом просмотре страницы.
Один планировщик на API-ключ — избегайте трёх cron-задач, синхронизирующих один и тот же каталог.
При HTTP 429 сделайте паузу на Retry-After секунд, затем повторите один раз с backoff.

Точные числа могут меняться; считайте документацию и ответы 429 источником истины.

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

API-ключ хранится в секретах, а не в git.
Проверка categories возвращает данные.
Синхронизация каталога