Резеллеры могут использовать единый API для синхронизации каталогов, создания заказов и отслеживания прогресса. Публичная документация не содержит ключей API; заказы оплачиваются с баланса вашего аккаунта. Храните ключи API на стороне сервера.
Синхронизация услуг и оформление заказов
Вызовите services, чтобы получить ID услуги, цену за тысячу, минимальное и максимальное количество, условия восполнения и формат ссылки.
Укажите публичную страницу или ссылку на конкретный контент в зависимости от типа услуги и отправьте через add. При размещении заказа количество, ссылка и баланс будут проверены повторно.
Сохраните возвращенный номер заказа AQNAB и вызовите status, чтобы увидеть актуальный статус после синхронизации, начальное количество и оставшееся количество.
Если запрос истёк по времени или результат неясен, сначала проверьте заказ и убедитесь вручную. Не переключайтесь на другой маршрут и не отправляйте повторно сразу. Только после подтверждения, что заказ не был принят, выберите другой сервис и отправьте снова.
Минимальный пример вызова
curl -X POST https://aqnab.com/api/v2 -d 'key=YOUR_API_KEY' -d 'action=services'
Метод: POST /api/v2. Принимает форму или JSON, возвращает JSON. Баланс: action=balance. Заказ: action=add с параметрами service, link, quantity. Статус: action=status с параметром order. Для своих комментариев передайте comments, для ключевых слов — keywords.
Дозаполнение, отмена и закупка через субпанели
status поддерживает пакетный запрос заказов (до 100 заказов); refill принимает order или orders, refill_status принимает refill или refills; cancel принимает orders. Запросы на восполнение и отмену принимаются только если сервис их поддерживает; запросы попадают в асинхронную очередь, и запрос на отмену не означает, что возврат средств был произведен.
Каждая страница API подразделения предоставляет отдельный ключ. Ключ подразделения использует закупочный баланс, предварительно пополненный вами на этом поставщике, и размещает заказы по ценам этого сайта; он не использует балансы других сайтов или основного сайта. При недостаточности закупочного баланса на любом уровне весь платёж отклоняется. Средства клиентов поступают на счёт, настроенный этим поставщиком.
API для публикации в блоге, каталогов и изображений
API публикации агента поддерживает создание черновиков, предпросмотр, редактирование, публикацию, список и удаление. Он использует отдельный ключ публикации и может быть ограничен основным сайтом или конкретным подсайтом. Тестируйте черновики перед публикацией финальных статей.
Получите ID услуги и текущую цену аккаунта из каталога услуг, затем используйте тот же ключ для размещения и проверки заказов.
HTTP-метод
POST
API URL
https://aqnab.com/api/v2
Формат запроса
JSON или форма (application/x-www-form-urlencoded)
Формат ответа
JSON · Цена в USD
Метод проверки
Передаётся в теле запросаkey. Ключ хранится только на сервере.
Запросить восполнение refill
Поддерживаются только заказы с пометкой refill=true и уже отправленные вышестоящему поставщику. Запросы сначала попадают в очередь; если ответ поставщика неясен, дождитесь проверки и не отправляйте повторно. Вы можете указать от 1 до 100 номеров заказов в поле orders.
Параметры
Тип
Описание
key
Строка
Обязательно. Ваш AQNAB API Key.
action
Строка
必填。固定为 refill。
order
Строка
Один ID заказа; для пакетных используйте ID через запятую.
Поддерживаются только незавершенные заказы с cancel=true. Возврат 1 означает, что запрос поставлен в очередь, а не отменен или возвращен. Продолжайте проверять статус заказа.
Параметры
Тип
Описание
key
Строка
Обязательно. Ваш AQNAB API Key.
action
Строка
必填。固定为 cancel。
orders
Строка
От 1 до 100 номеров заказов, разделённых запятыми.
Возвращает доступный баланс аккаунта, связанного с текущим API-ключом. Баланс представлен строкой с 4 знаками после запятой.
Параметры
Тип
Описание
key
Строка
Обязательно. Ваш AQNAB API Key.
action
Строка
必填。固定为 balance。
Тело запроса (JSON)
{
"key": "YOUR_KEY",
"action": "balance"
}
Пример успешного ответа
{
"balance": "12.5000",
"currency": "USD"
}
Создать заказ add
Создаёт реальный заказ и списывает оплату с баланса. Сумма = количество ÷ 1,000 × текущая цена за тысячу, с точностью до четырёх знаков после запятой. Сохраните номер заказа для проверки статуса. При тайм-ауте сначала проверьте заказ в панели, чтобы не создать дубликат.
Параметры
Тип
Описание
key
Строка
Обязательно. Ваш AQNAB API Key.
action
Строка
必填。固定为 add。
service
Строка
Обязательно. Используйте номер услуги, возвращаемый services, например AQ1-123.
link
Строка
Обязательно. Публично доступная ссылка http или https.
quantity
Целое число
Обязательно для обычных услуг, должно быть между min и max. Для пользовательских комментариев — по числу заполненных строк.
comments
Строка
Обязательно для своих комментариев: один комментарий в строке, всего до 20,000 символов. Пустые строки не учитываются.
keywords
Строка
Обязательно для услуг со своими ключевыми словами, до 2,000 символов. Для остальных услуг не требуется.
Вы можете запрашивать заказы только для текущего аккаунта. Передавайте заказы в пакетный запрос до 100 штук (через запятую); результаты пакетной выдачи индексируются по ID заказа. Статусы: Pending, In progress, Completed, Partial, Canceled. start_count и remains приходят из синхронизации статусов апстрима; они равны null, пока не возвращены. Статус апстрима не является независимым подтверждением фактической поставки.
Параметры
Тип
Описание
key
Строка
Обязательно. Ваш AQNAB API Key.
action
Строка
必填。固定为 status。
order
Строка
Обязательно. Поле order, возвращаемое при создании заказа.
Неверные параметры, недоступная услуга или недостаточно средств.
401
Ключ недействителен или был отозван.
404
Для этого аккаунта заказы не найдены.
500 / 502
Услуга временно недоступна. Если запрос на заказ не выполнен, сначала проверьте свои заказы и баланс.
Пример ответа с ошибкой
{
"error": "Insufficient funds"
}
Пример cURL-формы
curl -X POST https://aqnab.com/api/v2 \
--data-urlencode "key=YOUR_KEY" \
--data-urlencode "action=services"
登录后管理下单密钥Ключ публикации генерируется администратором в разделе SEO-оптимизации и передаётся безопасно.
FAQ
Какие операции доступны через API?
Текущая версия /api/v2 поддерживает services, balance, add, status. Синхронизация услуг используется для чтения текущих розничных цен и диапазонов, add создаёт реальный платный заказ, status проверяет прогресс после синхронизации с вышестоящим поставщиком.
Можно ли сразу переключиться на другую услугу при тайм-ауте?
Нет. Тайм-аут может означать, что заказ уже принят; сначала проверьте исходный заказ и вручную сверьте данные, затем решайте, создавать ли новый заказ. Текущая система не будет автоматически менять канал и повторно покупать при неопределённом результате отправки.
Как получить ключ?
После входа в систему в центре подключения API сгенерируйте ключ для заказов в соответствии с условиями аккаунта. Для публикации блога используется отдельный ключ публикации, который можно ограничить конкретным филиалом; его нельзя использовать для списания средств при заказах.
Может ли агент публиковать блог напрямую?
Можно использовать API публикации для создания черновика, после подтверждения предпросмотра обновить до published; поддерживаются список, изменение, удаление и загрузка изображений. Полные поля и ограничения частоты указаны в документации API.
Почему нельзя произвольно заменять ID услуги?
Каждый ID услуги соответствует конкретной услуге и каналу; цена, целевая ссылка, диапазон и послепродажное обслуживание могут отличаться. Сначала синхронизируйте каталог, отправляйте запросы по возвращённым ID и формату ссылок, не угадывайте номера.