Describa el intercambio
Para cada operación, documente el método, recurso, campos requeridos y la forma de una respuesta exitosa. Incluya un error de validación. Distinga una falla de transporte de una solicitud rechazada: la ausencia de una respuesta no prueba que una operación que cambia el estado haya fallado.
Trate las credenciales como configuración
Mantenga las credenciales del servidor fuera de los paquetes del navegador y de los repositorios de código fuente. Solicite el conjunto de permisos más pequeño que sea útil y separe el acceso de desarrollo del acceso de producción. Registre quién posee cada integración y cómo se puede revocar el acceso. Siga el flujo de autorización documentado por el proveedor.
Planifique para dependencias no disponibles
Establezca tiempos de espera, respete las pautas de limitación de velocidad y vuelva a intentar solo cuando sea seguro repetir una operación. Donde se admita, una clave de idempotencia puede identificar solicitudes repetidas. Registre un identificador de solicitud y una categoría de fallo concisa; evite encabezados de autorización, cookies de sesión y datos personales.