Inicio rápido de la API para clientes: Integre Accplanet /api/v2 en un solo bucle

Si compras en Accplanet programáticamente, no necesitas una API diferente para cada acción. La API de Cliente usa un solo endpoint — POST https://accplanet.com/api/v2 — y un parámetro action. Esta guía es un inicio rápido práctico para que un desarrollador pueda listar artículos del catálogo, verificar stock, realizar un pedido y consultar el estado en una sola sesión.

Accplanet es un mercado de agregación de proveedores. Los proveedores cumplen con el inventario; Accplanet ofrece descubrimiento, pago, seguimiento de pedidos y soporte. Usa la API solo para la gestión legítima de pedidos. Referencia completa: Documentación de la API de Cliente.

Autenticación y endpoint

Crea o copia tu clave de API de cliente desde la página de claves de API de tu perfil de Accplanet, luego llama:

POST https://accplanet.com/api/v2

{
  "key": "TU_CLAVE_API",
  "action": "categories"
}

Acciones compatibles: categories, shops, services, inventory, add, status, balance.

Escalera de integración

Detente cuando cada paso devuelva una respuesta limpia antes de continuar.

Recetas curl para copiar y pegar

# Balance
curl -X POST https://accplanet.com/api/v2 -d "key=TU_CLAVE_API" -d "action=balance"

# Página de servicios
curl -X POST https://accplanet.com/api/v2 \
  -d "key=TU_CLAVE_API" -d "action=services" -d "page=1" -d "limit=50"

# Inventario
curl -X POST https://accplanet.com/api/v2 \
  -d "key=TU_CLAVE_API" -d "action=inventory" -d "service=10042"

# Añadir pedido
curl -X POST https://accplanet.com/api/v2 \
  -d "key=TU_CLAVE_API" -d "action=add" -d "service=10042" -d "quantity=1"

# Estado
curl -X POST https://accplanet.com/api/v2 \
  -d "key=TU_CLAVE_API" -d "action=status" -d "order=TU_ID_PEDIDO"

Reemplaza los marcadores de posición con tu clave, un service real de services y el order devuelto por add. Comienza con cantidad 1 en un artículo de prueba de bajo costo.

Errores y límites de tasa

• Credenciales inválidas → HTTP 401 con {"error":"Invalid API key"}.
• Problemas de validación / stock / saldo → generalmente HTTP 400 con una sola cadena error (por ejemplo, stock o saldo insuficiente).
• Límite de tasa → HTTP 429 con Retry-After. Retrocede y reintenta.
• El tamaño de página predeterminado de servicios es 50 al paginar; usa limit=0 solo cuando quieras intencionalmente la lista completa.

Los precios, el stock y la disponibilidad cambian con los listados en vivo. Siempre vuelve a leer services / inventory antes de compras automatizadas.

Lista de verificación del comprador

• [ ] Clave de API almacenada en un gestor de secretos del servidor
• [ ] balance suficiente para un pedido de prueba pequeño
• [ ] Elegido un service con available=true
• [ ] Cantidad dentro de min/max
• [ ] ID de order persistido desde add y consulta de status
• [ ] Manejo de 429 y errores de billetera en el código

Siguiente paso: abre la documentación de la API de Cliente, ejecuta Probar API una vez y luego conecta las mismas acciones en tu backend. Los proveedores que integran sincronización de catálogo deberían leer la guía complementaria para proveedores en el blog de Accplanet.

Preguntas frecuentes