Mejores Prácticas de Integraciones
Interrumpe las llamadas del proveedor; no bloquees el hilo de la solicitud en latencia externa ilimitada.
//
Busca en todas las páginas de la documentación
Interrumpe las llamadas del proveedor; no bloquees el hilo de la solicitud en latencia externa ilimitada.
AppError con códigos estables para los clientes.Retry-After en 429 de los socios.express.json().apiVersion de Stripe fijada en el código.Máximo 0-2 reintentos rápidos. Reintento masivo en la cola de trabajadores.
Reintento del SDK o de la aplicación, no ambos sin configurar. Stripe: habilita con claves de idempotencia.
Requerido para pruebas unitarias. Pruebas de contrato opcionales contra sandbox semanalmente.
URLs de punto final y secretos de firma separados por entorno.
Casi nunca. Envuelve en el servicio; los problemas ascendentes van al proveedor o a un parche delgado.
Las mismas reglas de tiempo de espera/reintento/idempotencia a través del cliente got/axios.
Bloqueantes solo cuando el usuario espera el resultado. Todo lo demás, cola.
Importa clientes modulares (estilo AWS v3). Tree-shake Stripe si usas compilaciones de subconjuntos.
Sin tiempo de espera en la llamada saliente: el grupo de hilos se estanca bajo la lentitud del proveedor.
Lee la documentación de reintentos, idempotencia y webhooks del proveedor antes de escribir código.
Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS Activo), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.
Revisado por Chris St. John·Última actualización: 16 jul 2026