Inicio rápido de la API de clientes de Accplanet: listar, consultar stock y realizar pedidos

By Olivia Chen

septiembre 13, 2026 Buyer Tips 👁 156 vistas

Accplanet Customer API API key api design principles POST /api/v2 reseller API integration check stock API place order API Accplanet services API

Accplanet Customer API quick start

Get an API key and call POST /api/v2 to list services, check inventory, place an order, and poll status.

Create an API key
Open Profile → API key on Accplanet, generate a key, and store it in a secret environment variable.
List services and check stock
POST https://accplanet.com/api/v2 with action=services (cache results), then action=inventory for target service IDs.
Place order and poll status
POST action=add with service and quantity, then poll action=status with the returned order id. Honor HTTP 429 Retry-After.

Si compras en Accplanet de forma programática, no necesitas una URL diferente para cada acción. La Accplanet Customer API utiliza un único endpoint — POST https://accplanet.com/api/v2 — más un parámetro action. Esta guía es un inicio rápido práctico para que un revendedor o una automatización puedan listar artículos del catálogo, consultar stock, realizar un pedido y consultar el estado en una sola sesión.

Accplanet es un marketplace de proveedores. La Customer API es para compradores y revendedores que ya tienen un saldo. Las tablas completas de parámetros están en la documentación de la Customer API; esta publicación se centra en la ruta funcional más corta.

En resumen

Crea una clave de API en tu perfil de Accplanet y guárdala como una contraseña.
Llama a POST https://accplanet.com/api/v2 con key + action (campos de formulario o JSON).
Bucle típico de revendedor: services → inventory → add → status (opcional balance).
Almacena en caché las lecturas del catálogo. Trata HTTP 429 + Retry-After como un retroceso obligatorio, no como una sugerencia opcional.
Usa esta publicación para integrarte rápido; usa la documentación oficial para cada campo.

Obtén tu clave de API

Inicia sesión, abre Perfil → Clave de API y genera una clave de API. Cópiala una vez en un gestor de secretos o variable de entorno (por ejemplo ACCPLANET_API_KEY). Cada llamada a la Customer API se autentica con esa clave en el cuerpo como key (alias apikey).

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

También puedes enviar campos codificados como formulario con curl -d. Prefiere variables de entorno en lugar de cadenas codificadas directamente.

Principios de diseño de la API (por qué un solo endpoint)

La Customer API de Accplanet sigue algunos principios de diseño de API prácticos que simplifican la integración de revendedores:

Punto de entrada único: una URL, muchos valores de action — menos URLs base que configurar.
Autenticación explícita: la clave de API viaja con cada solicitud; no se requiere una cookie de sesión opaca para los scripts.
Vocabulario de acciones: services, inventory, add, status, balance y acciones relacionadas se asignan claramente a catálogo → stock → pedido → consulta.
Estructura de errores estable: las llamadas fallidas devuelven errores estructurados; los límites de velocidad usan HTTP 429.

Ese diseño es la razón por la que un cliente mínimo suele ser un envoltorio fino: establecer la clave, elegir la acción, analizar el JSON.

Escalera de integración

1 · Prueba de humo

Listar categorías

Confirma que la clave funciona antes de conectar la lógica de pedidos.

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=categories"

2 · Catálogo

Obtener servicios (productos)

Usa action=services para la API de servicios de Accplanet / sincronización de catálogo. Prefiere un limit mayor (hasta 500) y almacena la respuesta en caché local durante al menos 60–120 segundos. Esta es la acción en la que los revendedores alcanzan los límites de velocidad primero.

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "limit=100"

3 · Stock

Consultar inventario antes de agregar

Para una ruta de API de consulta de stock, llama a action=inventory con los IDs de servicio que te interesen. Omite las llamadas ciegas a add cuando el stock ya sea cero en tu caché.

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=inventory" \
  -d "services=10042"

4 · Pedido

Realizar pedido, luego consultar estado

API de realizar pedido: action=add con service y opcionalmente quantity / link. Luego consulta con action=status y el id de pedido devuelto. No consultes el estado cada segundo.

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=10042" \
  -d "quantity=1"

curl -X POST https://accplanet.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=ORDER_ID"

Límites de velocidad que rompen las primeras integraciones

El tráfico autenticado de la Customer API está limitado por cuotas de ráfaga, globales y por acción. Reglas prácticas para la integración de la API de revendedores:

Almacena en caché services; actualiza según un calendario (a menudo 2–5 minutos), no en cada vista de página.
Un programador por clave de API — evita tres tareas cron sincronizando el mismo catálogo.
Ante HTTP 429, espera Retry-After segundos, luego reintenta una vez con retroceso.

Los números exactos pueden cambiar; trata la documentación y las respuestas 429 como fuente de verdad.

Lista de verificación del comprador

Clave de API almacenada en secretos, no en git.
La prueba de humo categories devuelve datos.
La sincronización del catálogo usa services + caché local.
Los pedidos usan inventory y luego add, después una consulta lenta de status.
Manejador de 429 implementado antes del tráfico