Guía de integración de la API de AQNAB

La API permite a los revendedores sincronizar el catálogo, crear pedidos y consultar su progreso. Los pedidos se pagan con el saldo de la cuenta. Guarda las claves en tu servidor; la documentación pública no contiene credenciales.

Sincronizar servicios y crear pedidos

  1. Llama a services para obtener el ID del servicio, el precio por mil, las cantidades mínima y máxima, las condiciones de reposición y el formato del enlace.
  2. Según el servicio, indica un perfil público o el enlace del contenido y envía la solicitud con add. Se verificarán la cantidad, el destino y el saldo.
  3. Guarda el número de pedido de AQNAB y consulta status para obtener el estado sincronizado con el proveedor, el recuento inicial y la cantidad pendiente.
  4. Si la solicitud tarda demasiado o el resultado es incierto, consulta el pedido y verifica lo ocurrido antes de volver a enviarlo. Cambia de servicio únicamente cuando se confirme que el pedido anterior no fue aceptado.

Ejemplo básico

curl -X POST https://aqnab.com/api/v2 -d 'key=YOUR_API_KEY' -d 'action=services'

Interfaz: POST /api/v2. Acepta formularios o JSON y devuelve JSON. Para consultar el saldo: action=balance. Para crear un pedido: action=add, con service, link y quantity. Para consultar el estado: action=status, con order. Los comentarios personalizados requieren comments; los servicios de palabras clave requieren keywords.

Reposición, cancelaciones y compras para paneles

status admite orders para consultar hasta 100 pedidos. Para refill, envía order u orders; para refill_status, refill o refills; para cancel, orders. La reposición y la cancelación dependen de que el servicio las admita y se tramitan en una cola. Solicitar la cancelación no confirma un reembolso.

Cada panel ofrece su propia clave en la página de acceso a la API. La clave utiliza el saldo de compra que hayas recargado en ese proveedor y sus precios; no utiliza el saldo de otros paneles ni del sitio principal. Si falta saldo en algún nivel de la cadena, se rechaza el cargo completo. Las recargas de los clientes llegan a la cuenta de cobro configurada en ese proveedor.

API de artículos, catálogo e imágenes

La API editorial permite crear borradores, previsualizar, editar, publicar, listar y eliminar artículos. Usa una clave de publicación independiente, limitada al sitio principal o al panel indicado. Comprueba primero un borrador.

Ver documentación completa y campos de la API →

Gestión de claves

AQNAB API V2

Documentación de la API

Consulta los IDs y precios de tu cuenta en el catálogo. Usa la misma clave para crear y consultar pedidos.

Método HTTP
POST
Endpoint
https://aqnab.com/api/v2
Formato de la solicitud
JSON o formulario (application/x-www-form-urlencoded)
Formato de respuesta
JSON · Precios en USD
Autenticación
Incluye en el cuerpo key. Guarda la clave únicamente en el servidor.

Solicitar reposición refill

Solo admite pedidos de esta cuenta enviados al proveedor y cuyo servicio tenga refill=true. La solicitud entra en una cola; si la respuesta del proveedor no es concluyente, se espera a verificarla sin repetir el envío. orders admite de 1 a 100 números de pedido.

ParámetroTipoDescripción
keyCadena de textoObligatorio. Tu API Key de AQNAB.
actionCadena de texto必填。固定为 refill。
orderCadena de textoUn número de pedido. Para varios, usa orders y sepáralos con comas.
Cuerpo de la solicitud (JSON)
{
  "key": "YOUR_KEY",
  "action": "refill",
  "order": "API-EXAMPLE-4ABC"
}
Ejemplo de respuesta correcta
{
  "refill": "AQR-EXAMPLE"
}

Estado de la reposición refill_status

Devuelve Pending, Completed, Rejected o Pending review. refills admite de 1 a 100 identificadores de reposición.

ParámetroTipoDescripción
keyCadena de textoObligatorio. Tu API Key de AQNAB.
actionCadena de texto必填。固定为 refill_status。
refillCadena de textoIdentificador recibido al solicitar la reposición. Para varios, usa refills.
Cuerpo de la solicitud (JSON)
{
  "key": "YOUR_KEY",
  "action": "refill_status",
  "refill": "AQR-EXAMPLE"
}
Ejemplo de respuesta correcta
{
  "status": "Pending"
}

Solicitar cancelación cancel

Solo admite pedidos que aún no han finalizado y cuyo servicio tenga cancel=true. El valor 1 indica que la solicitud está en cola; no confirma una cancelación ni un reembolso. Sigue consultando el estado del pedido.

ParámetroTipoDescripción
keyCadena de textoObligatorio. Tu API Key de AQNAB.
actionCadena de texto必填。固定为 cancel。
ordersCadena de textoDe 1 a 100 números de pedido, separados por comas.
Cuerpo de la solicitud (JSON)
{
  "key": "YOUR_KEY",
  "action": "cancel",
  "orders": "API-EXAMPLE-4ABC"
}
Ejemplo de respuesta correcta
[
  {
    "order": "API-EXAMPLE-4ABC",
    "cancel": 1
  }
]

Lista de servicios services

Devuelve el catálogo disponible para la cuenta actual. Usa la cadena service al hacer el pedido; rate indica el precio de venta en dólares por cada 1,000 unidades. Si aparece required, envía los parámetros indicados en esa lista. refill / cancel indican si el servicio admite solicitudes de reposición o cancelación.

ParámetroTipoDescripción
keyCadena de textoObligatorio. Tu API Key de AQNAB.
actionCadena de texto必填。固定为 services。
Cuerpo de la solicitud (JSON)
{
  "key": "YOUR_KEY",
  "action": "services"
}
Ejemplo de respuesta correcta
[
  {
    "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"
    ]
  }
]

Consultar saldo balance

Devuelve el saldo disponible de la cuenta a la que pertenece la API Key, como cadena de texto con 4 decimales.

ParámetroTipoDescripción
keyCadena de textoObligatorio. Tu API Key de AQNAB.
actionCadena de texto必填。固定为 balance。
Cuerpo de la solicitud (JSON)
{
  "key": "YOUR_KEY",
  "action": "balance"
}
Ejemplo de respuesta correcta
{
  "balance": "12.5000",
  "currency": "USD"
}

Crear pedido add

Crea un pedido real y descuenta su importe del saldo. Total = cantidad ÷ 1,000 × precio actual por mil, con cuatro decimales. Guarda el número de pedido para consultarlo después. Si la solicitud agota el tiempo de espera, comprueba primero el pedido en el panel para evitar duplicados.

ParámetroTipoDescripción
keyCadena de textoObligatorio. Tu API Key de AQNAB.
actionCadena de texto必填。固定为 add。
serviceCadena de textoObligatorio. Usa el identificador devuelto por services, por ejemplo AQ1-123.
linkCadena de textoObligatorio. Enlace de destino público y accesible mediante http o https.
quantityNúmero enteroObligatorio para servicios estándar, entre min y max. En los comentarios personalizados, la cantidad se calcula por las líneas válidas.
commentsCadena de textoObligatorio para comentarios personalizados: uno por línea y hasta 20,000 caracteres en total. Las líneas vacías no cuentan.
keywordsCadena de textoObligatorio si el servicio requiere palabras clave personalizadas, con un máximo de 2,000 caracteres. No hace falta para otros servicios.
Cuerpo de la solicitud (JSON)
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ1-123",
  "link": "https://www.tiktok.com/@example",
  "quantity": 1000
}
Ejemplo de respuesta correcta
{
  "order": "API-EXAMPLE-4ABC"
}
Ejemplos para comentarios y palabras clave personalizados
Comentarios personalizados
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ2-456",
  "link": "https://www.tiktok.com/@example/video/123",
  "comments": "第一条评论\n第二条评论"
}
Palabras clave personalizadas
{
  "key": "YOUR_KEY",
  "action": "add",
  "service": "AQ3-789",
  "link": "https://example.com/",
  "quantity": 1000,
  "keywords": "品牌名, 产品名"
}

Consultar estado del pedido status

Solo permite consultar pedidos de esta cuenta. Con orders puedes consultar hasta 100 pedidos separados por comas; la respuesta agrupa los resultados por número de pedido. Los estados incluyen Pending, In progress, Completed, Partial y Canceled. start_count y remains se sincronizan con el proveedor y son null mientras no se hayan recibido. El estado del proveedor no es una prueba independiente de la entrega real.

ParámetroTipoDescripción
keyCadena de textoObligatorio. Tu API Key de AQNAB.
actionCadena de texto必填。固定为 status。
orderCadena de textoObligatorio. Valor del campo order recibido al crear el pedido.
Cuerpo de la solicitud (JSON)
{
  "key": "YOUR_KEY",
  "action": "status",
  "order": "API-EXAMPLE-4ABC"
}
Ejemplo de respuesta correcta
{
  "charge": "0.9000",
  "start_count": "0",
  "status": "In progress",
  "remains": "1000",
  "currency": "USD"
}

Gestión de errores

Estado HTTPDescripción
400Parámetros incorrectos, servicio no disponible o saldo insuficiente.
401Clave incorrecta o revocada.
404No se encontró el pedido en esta cuenta.
500 / 502Servicio no disponible temporalmente. Si falla la solicitud, comprueba los pedidos y el saldo antes de volver a enviarla.
Ejemplo de respuesta de error
{
  "error": "Insufficient funds"
}
Ejemplo de formulario con cURL
curl -X POST https://aqnab.com/api/v2 \
  --data-urlencode "key=YOUR_KEY" \
  --data-urlencode "action=services"

登录后管理下单密钥. El responsable del sitio genera las claves editoriales en la sección de SEO y las comparte de forma segura.

Preguntas frecuentes

¿Qué puedo hacer con la API?

/api/v2 permite consultar el catálogo con services, el saldo con balance, crear pedidos con add y consultar su estado con status. services devuelve los precios de venta y los límites actuales. add crea un pedido real de pago; status muestra el progreso sincronizado con el proveedor.

¿Puedo cambiar de servicio si la solicitud tarda demasiado?

Primero consulta y verifica el pedido original: el proveedor podría haberlo aceptado aunque la solicitud haya agotado el tiempo de espera. Después podrás decidir si necesitas otro pedido. El sistema no cambia automáticamente de servicio ni repite la compra cuando el resultado del envío es incierto.

¿Cómo consigo una clave API?

Inicia sesión y genera una clave de pedidos en la sección API, según las condiciones de tu cuenta. Para publicar artículos se utiliza una clave independiente, que puede limitarse a un panel concreto y no permite crear pedidos de pago.

¿Los distribuidores pueden publicar artículos por API?

La API de publicación permite crear un borrador, revisar su vista previa y cambiar su estado a published. También admite listar, editar y eliminar artículos, y subir imágenes. Consulta los campos y los límites de uso en la documentación.

¿Por qué no debo sustituir un ID de servicio sin comprobarlo?

Cada ID corresponde a un servicio concreto, con su precio, destino, límites y condiciones de asistencia. Sincroniza primero el catálogo y utiliza el ID y el formato de enlace que devuelve. No adivines los identificadores.

Catálogo de servicios · Guía detallada de la API · Panel con tu propia marca