Вернуться к руководству

API: услуги, цены, заказы, статусы и refill

Параметры и ответы опубликованных действий.

Обновлено:

Порядок действий

  1. services возвращает массив с service, description, platform, min, max, rate, price_per_item, pricing_unit, refill, cancel и EUR. rate — ориентир за 1000, не универсальный расчёт.
  2. balance возвращает баланс. add требует service, link и quantity. Сохраните order, charge и currency. Сумму и минимальную стоимость рассчитывает тот же механизм, что на сайте.
  3. Используйте постоянный idempotency_key для покупки и её повторов: необязательный, до 120 символов, привязан к ключу API.
  4. status принимает order или orders: до 100 числовых ID через запятую только ваших API-заказов. start_count и remains сейчас null.
  5. refill принимает order и при принятии возвращает идентификатор. Действий для статуса refill и отмены не опубликовано; cancel в каталоге не является endpoint.

Важно

Статусы API: Pending, In progress, Processing, Partial, Completed, Canceled. Не вычисляйте остаток из null и не считайте refill гарантированным.

Примеры API

services

curl --request POST https://nexwa.store/api/v2 \
  --header "Authorization: Bearer ${NEXWA_API_KEY}" \
  --data-urlencode "action=services"

balance

curl --request POST https://nexwa.store/api/v2 \
  --header "Authorization: Bearer ${NEXWA_API_KEY}" \
  --data-urlencode "action=balance"

add

curl --request POST https://nexwa.store/api/v2 \
  --header "Authorization: Bearer ${NEXWA_API_KEY}" \
  --data-urlencode "action=add" \
  --data-urlencode "service=${NEXWA_SERVICE_ID}" \
  --data-urlencode "link=${NEXWA_TARGET_URL}" \
  --data-urlencode "quantity=${NEXWA_QUANTITY}" \
  --data-urlencode "idempotency_key=${NEXWA_PURCHASE_ID}"

status

curl --request POST https://nexwa.store/api/v2 \
  --header "Authorization: Bearer ${NEXWA_API_KEY}" \
  --data-urlencode "action=status" \
  --data-urlencode "order=${NEXWA_ORDER_ID}"

refill

curl --request POST https://nexwa.store/api/v2 \
  --header "Authorization: Bearer ${NEXWA_API_KEY}" \
  --data-urlencode "action=refill" \
  --data-urlencode "order=${NEXWA_ORDER_ID}"

Публичный справочник API

POST https://nexwa.store/api/v2
ДействиеПараметрыОтвет
servicesactionArray<{service, name, category, platform, type, rate, price_per_item, pricing_unit, description, min, max, refill, cancel, currency}>
balanceaction{balance, currency}
addaction, service, link, quantity, idempotency_key?{order, charge, currency, balance?} | {order, duplicate: true}
statusaction, order | orders{charge, start_count: null, status, remains: null, currency} | {"<order>": result}
refillaction, order{refill}

Открыть функцию

Ключи APIЦены

Связанные статьи

Нужна помощь?

Откройте поддержку в аккаунте для конкретного запроса. Если вход недоступен, напишите нам.

Открыть поддержкуНаписать по почте