Руководство по интеграции с API AQNAB

Резеллеры могут использовать единый API для синхронизации каталогов, создания заказов и отслеживания прогресса. Публичная документация не содержит ключей API; заказы оплачиваются с баланса вашего аккаунта. Храните ключи API на стороне сервера.

Синхронизация услуг и оформление заказов

  1. Вызовите services, чтобы получить ID услуги, цену за тысячу, минимальное и максимальное количество, условия восполнения и формат ссылки.
  2. Укажите публичную страницу или ссылку на конкретный контент в зависимости от типа услуги и отправьте через add. При размещении заказа количество, ссылка и баланс будут проверены повторно.
  3. Сохраните возвращенный номер заказа AQNAB и вызовите status, чтобы увидеть актуальный статус после синхронизации, начальное количество и оставшееся количество.
  4. Если запрос истёк по времени или результат неясен, сначала проверьте заказ и убедитесь вручную. Не переключайтесь на другой маршрут и не отправляйте повторно сразу. Только после подтверждения, что заказ не был принят, выберите другой сервис и отправьте снова.

Минимальный пример вызова

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 публикации агента поддерживает создание черновиков, предпросмотр, редактирование, публикацию, список и удаление. Он использует отдельный ключ публикации и может быть ограничен основным сайтом или конкретным подсайтом. Тестируйте черновики перед публикацией финальных статей.

Посмотреть полную документацию агентского API и таблицу полей →

Управление ключами

AQNAB API V2

Документация по 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 через запятую.
Тело запроса (JSON)
{
  "key": "YOUR_KEY",
  "action": "refill",
  "order": "API-EXAMPLE-4ABC"
}
Пример успешного ответа
{
  "refill": "AQR-EXAMPLE"
}

Ход дозаполнения refill_status

Возвращает статусы: ожидает, завершено, отклонено или на проверке. Дозаказы можно отправлять партиями от 1 до 100 ID дозаказов.

ПараметрыТипОписание
keyСтрокаОбязательно. Ваш AQNAB API Key.
actionСтрока必填。固定为 refill_status。
refillСтрокаID, возвращаемый при запросе дозаполнения; для массовых операций используйте refills.
Тело запроса (JSON)
{
  "key": "YOUR_KEY",
  "action": "refill_status",
  "refill": "AQR-EXAMPLE"
}
Пример успешного ответа
{
  "status": "Pending"
}

Запросить отмену cancel

Поддерживаются только незавершенные заказы с cancel=true. Возврат 1 означает, что запрос поставлен в очередь, а не отменен или возвращен. Продолжайте проверять статус заказа.

ПараметрыТипОписание
keyСтрокаОбязательно. Ваш AQNAB API Key.
actionСтрока必填。固定为 cancel。
ordersСтрокаОт 1 до 100 номеров заказов, разделённых запятыми.
Тело запроса (JSON)
{
  "key": "YOUR_KEY",
  "action": "cancel",
  "orders": "API-EXAMPLE-4ABC"
}
Пример успешного ответа
[
  {
    "order": "API-EXAMPLE-4ABC",
    "cancel": 1
  }
]

Список услуг services

Возвращает каталог услуг, доступных текущему аккаунту. При заказе используйте строку service; rate — цена в долларах за 1,000 единиц. Если указан required, передайте перечисленные параметры. refill / cancel показывают, доступны ли запросы на восполнение и отмену.

ПараметрыТипОписание
keyСтрокаОбязательно. Ваш AQNAB API Key.
actionСтрока必填。固定为 services。
Тело запроса (JSON)
{
  "key": "YOUR_KEY",
  "action": "services"
}
Пример успешного ответа
[
  {
    "service": "AQ1-123",
    "name": "TikTok 粉丝",
    "type": "Default",
    "category": "TikTok - 粉丝",
    "rate": "0.900",
    "min": 50,
    "max": 10000,
    "refill": false,
    "cancel": false
  },
  {
    "service": "AQ2-456",
    "name": "TikTok 自定义评论",
    "type": "Custom Comments",
    "category": "TikTok - 评论",
    "rate": "8.00",
    "min": 1,
    "max": 100,
    "refill": false,
    "cancel": false,
    "required": [
      "link",
      "comments"
    ]
  }
]

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

Возвращает доступный баланс аккаунта, связанного с текущим 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 символов. Для остальных услуг не требуется.
Тело запроса (JSON)
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ1-123",
  "link": "https://www.tiktok.com/@example",
  "quantity": 1000
}
Пример успешного ответа
{
  "order": "API-EXAMPLE-4ABC"
}
Запросить примеры для своих комментариев и ключевых слов
Свои комментарии
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ2-456",
  "link": "https://www.tiktok.com/@example/video/123",
  "comments": "第一条评论\n第二条评论"
}
Свои ключевые слова
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ3-789",
  "link": "https://example.com/",
  "quantity": 1000,
  "keywords": "品牌名, 产品名"
}

Проверить статус заказа status

Вы можете запрашивать заказы только для текущего аккаунта. Передавайте заказы в пакетный запрос до 100 штук (через запятую); результаты пакетной выдачи индексируются по ID заказа. Статусы: Pending, In progress, Completed, Partial, Canceled. start_count и remains приходят из синхронизации статусов апстрима; они равны null, пока не возвращены. Статус апстрима не является независимым подтверждением фактической поставки.

ПараметрыТипОписание
keyСтрокаОбязательно. Ваш AQNAB API Key.
actionСтрока必填。固定为 status。
orderСтрокаОбязательно. Поле order, возвращаемое при создании заказа.
Тело запроса (JSON)
{
  "key": "YOUR_KEY",
  "action": "status",
  "order": "API-EXAMPLE-4ABC"
}
Пример успешного ответа
{
  "charge": "0.9000",
  "start_count": "0",
  "status": "In progress",
  "remains": "1000",
  "currency": "USD"
}

Обработка ошибок

HTTP-статусОписание
400Неверные параметры, недоступная услуга или недостаточно средств.
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 и формату ссылок, не угадывайте номера.

Каталог услуг · Подробное руководство по API · Белый филиал