El éxito de la API no garantiza la integridad de los datos
Una respuesta exitosa de la API solo indica que se procesó una solicitud; el resultado puede estar sujeto a restricciones de número de página, intervalo de tiempo, período de retención y permisos. Antes de exportar los registros de transacciones, aclare si la API devuelve un pedido, una transacción o un cambio en el libro mayor, y verifique el alcance de la cuenta, la subcuenta y el producto. La primera página predeterminada no puede considerarse el historial completo, ni una matriz vacía puede interpretarse directamente como una cuenta que nunca ha estado activa.
Los métodos de paginación deben implementarse de acuerdo con la documentación.
Las diferentes interfaces utilizan la hora, los identificadores de eventos o los cursores anterior/siguiente para la paginación, y la clasificación y la inclusión de límites también pueden variar. Guarde los parámetros de cada solicitud, el rango de respuesta y el cursor siguiente; no asuma que agregar un segundo a la hora evitará omisiones. Pueden ocurrir varios registros en el mismo milisegundo; los identificadores estables suelen ser más adecuados para la asociación que las marcas de tiempo únicas, pero su alcance debe confirmarse.
Utilice ventanas superpuestas para identificar problemas.
Las ventanas adyacentes pueden tener una pequeña superposición; en ese caso, se debe realizar la deduplicación utilizando una clave de evento específica. Esto ayuda a verificar los límites; la deduplicación simple no debe ocultar los cambios de campo. Si se producen varias transacciones en un mismo momento, la división de ventanas que solo conserva el primer registro provocará omisiones. Registre las horas más temprana y más tardía, el número de registros devueltos y los cambios de cursor. Deténgase e investigue si la misma página aparece repetidamente.
La limitación de velocidad y los reintentos deben ser recuperables.
Limite las solicitudes en lotes según la tasa oficial. Evite los reintentos cuando encuentre limitaciones de velocidad o fallos temporales, y continúe desde el cursor confirmado. No agregue permisos de API innecesarios para mejorar la velocidad, ni actualice las claves de lectura de datos a claves revocables. Las claves y firmas no deben registrarse. Registrar los resúmenes de las solicitudes es suficiente para la verificación, y los archivos de registro también deben proteger la información relacionada con la cuenta.
La integridad depende de la verificación cruzada.
Compare las cantidades de transacciones exportadas, las comisiones y los cambios de activos con los informes de cuenta, los estados de cuenta mensuales o los saldos iniciales y finales. Las transferencias entrantes y salientes, las recompensas y los ajustes pueden provenir de otras interfaces; los registros de transacciones no pueden explicar el saldo completo. Las discrepancias inexplicables deben marcarse por separado; no fabrique una transacción suplementaria. Si el historial ha excedido el período de retención de la interfaz, consulte los informes oficiales o los tickets de soporte.
Genere paquetes de datos auditables.
Guarde la versión del documento de la interfaz, la hora de exportación, el rango de cuentas, los parámetros de paginación, el número de filas, las reglas de deduplicación y la lista de excepciones, conservando una copia segura de la respuesta original. Las afirmaciones de integridad de las herramientas de terceros también deben poder verificarse mediante estos registros. Este documento se utiliza únicamente para el procesamiento de datos y no garantiza la disponibilidad permanente de ninguna interfaz específica, ni genera automáticamente conclusiones fiscales ni evaluaciones de solvencia de la plataforma.