El Admin API y webhooks en la práctica
Las integraciones contra Shopify son principalmente dos mecanismos: el Admin API, que llamas para leer y escribir, y webhooks, que te llaman cuando algo sucede.
Ambos son directos. Lo que separa una integración confiable de una inestable es cómo manejas los casos donde se comportan mal — y lo harán.
Los dos mecanismos#
| Admin API | Webhooks | |
|---|---|---|
| Dirección | Tú llamas a Shopify | Shopify te llama |
| Bueno para | Leer estado, escribir cambios, rellenos | Reaccionar a eventos prontamente |
| Modo de fallo | Límites de tasa, cambios de versión | Duplicados, entrega desordenada, eventos perdidos |
| Debe manejar | Reintentos y paginación | Idempotencia y verificación |
Reglas que hacen confiables las integraciones#
- Verifica cada firma de webhook antes de confiar en la carga. Los endpoints no verificados son una puerta abierta.
- Haz cada manejador idempotente — el mismo evento llegará dos veces eventualmente.
- No asumas orden. Una cancelación puede llegar antes de la creación que estabas esperando.
- Devuelve rápidamente y procesa asincrónicamente; los endpoints lentos se reintentan y luego se deshabilitan.
- Reconcilia diariamente contra el API. Los webhooks pierden eventos; un barrido nocturno atrapa lo que se escapó.
Los límites de tasa son un dato de diseño#
Shopify mide el acceso al API. Eso no es un obstáculo que sortear con reintentos; es una restricción para la que diseñar. Agrupa lecturas, solicita solo los campos que necesitas, y usa operaciones masivas para rellenos en lugar de recorrer cada producto una llamada a la vez.
Si tu integración solo funciona cuando nada más está ejecutándose, no funciona. Pruébala mientras una importación está en progreso.
Versionado#
Las versiones del API están fechadas y expiran. Pon la actualización en el calendario en lugar de descubrirla a través de un fallo. Una integración pequeña toma una hora para avanzar; una que ha saltado cuatro versiones toma una semana.
Preguntas frecuentes
¿Webhooks o sondeo?
Webhooks para prontitud, una reconciliación periódica para corrección. La mayoría de integraciones confiables usan ambos.
¿Cómo detengo el procesamiento duplicado?
Almacena el identificador del evento e ignora repeticiones. La idempotencia es el hábito más valioso aquí.
¿Qué se rompe primero a escala?
Límites de tasa, usualmente durante un relleno que recorre registros uno a la vez en lugar de usar operaciones masivas.
shopify admin apishopify webhooksintegración shopifylímites tasa api shopifyshopify graphql api
