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
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.
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.
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.
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.
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ámetro
Tipo
Descripción
key
Cadena de texto
Obligatorio. Tu API Key de AQNAB.
action
Cadena de texto
必填。固定为 refill。
order
Cadena de texto
Un número de pedido. Para varios, usa orders y sepáralos con comas.
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ámetro
Tipo
Descripción
key
Cadena de texto
Obligatorio. Tu API Key de AQNAB.
action
Cadena de texto
必填。固定为 cancel。
orders
Cadena de texto
De 1 a 100 números de pedido, separados por comas.
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.
Devuelve el saldo disponible de la cuenta a la que pertenece la API Key, como cadena de texto con 4 decimales.
Parámetro
Tipo
Descripción
key
Cadena de texto
Obligatorio. Tu API Key de AQNAB.
action
Cadena 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ámetro
Tipo
Descripción
key
Cadena de texto
Obligatorio. Tu API Key de AQNAB.
action
Cadena de texto
必填。固定为 add。
service
Cadena de texto
Obligatorio. Usa el identificador devuelto por services, por ejemplo AQ1-123.
link
Cadena de texto
Obligatorio. Enlace de destino público y accesible mediante http o https.
quantity
Número entero
Obligatorio para servicios estándar, entre min y max. En los comentarios personalizados, la cantidad se calcula por las líneas válidas.
comments
Cadena de texto
Obligatorio para comentarios personalizados: uno por línea y hasta 20,000 caracteres en total. Las líneas vacías no cuentan.
keywords
Cadena de texto
Obligatorio si el servicio requiere palabras clave personalizadas, con un máximo de 2,000 caracteres. No hace falta para otros servicios.
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ámetro
Tipo
Descripción
key
Cadena de texto
Obligatorio. Tu API Key de AQNAB.
action
Cadena de texto
必填。固定为 status。
order
Cadena de texto
Obligatorio. Valor del campo order recibido al crear el pedido.
Parámetros incorrectos, servicio no disponible o saldo insuficiente.
401
Clave incorrecta o revocada.
404
No se encontró el pedido en esta cuenta.
500 / 502
Servicio 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.