API 성공이 완전한 데이터를 보장하지는 않습니다.
API 반환 성공은 하나의 요청이 처리되었음을 의미할 뿐이며, 결과는 페이지 수, 시간 범위, 보존 기간 및 권한 제한의 적용을 받을 수 있습니다. 거래 기록을 내보내기 전에 API가 주문, 거래 또는 원장 변경 중 어떤 것을 반환하는지 명확히 하고 계정, 하위 계정 및 제품 범위를 확인하십시오. 기본 첫 페이지는 전체 내역으로 간주할 수 없으며, 빈 배열을 계정이 활성화된 적이 없다고 직접 해석할 수도 없습니다.
페이지네이션 메서드는 문서에 따라 구현해야 합니다.
인터페이스에 따라 페이지네이션에 시간, 이벤트 식별자 또는 이전/다음 커서를 사용할 수 있으며, 정렬 및 경계 포함 방식도 다를 수 있습니다. 각 요청의 매개변수, 응답 범위 및 다음 커서를 저장하십시오. 시간에 1초를 더한다고 해서 누락이 발생하지 않는다고 가정하지 마십시오. 동일한 밀리초에 여러 레코드가 발생할 수 있습니다. 일반적으로 단일 타임스탬프보다 안정적인 식별자가 연결에 더 적합하지만, 해당 범위도 확인해야 합니다.
겹치는 창을 사용하여 문제를 식별하십시오.
인접한 창은 약간의 중복이 있을 수 있으므로, 특정 이벤트 키를 사용하여 중복 제거를 수행해야 합니다. 이는 경계를 확인하는 데 도움이 되며, 단순 중복 제거는 필드 변경 사항을 가리지 않아야 합니다. 한 시점에 여러 거래가 발생하는 경우, 첫 번째 레코드만 유지하는 창 분할 방식은 누락을 초래할 수 있습니다. 가장 빠른 시간과 가장 늦은 시간, 반환된 레코드 수, 커서 변경 사항을 기록해야 합니다. 동일한 페이지가 반복적으로 나타나는 경우 작업을 중지하고 조사해야 합니다.
속도 제한 및 재시도 시 복구가 가능해야 합니다.
공식 속도에 따라 배치 요청을 제한해야 합니다. 속도 제한이나 일시적인 오류가 발생하는 경우 재시도를 피하고 확인된 커서에서 계속 진행해야 합니다. 속도 향상을 위해 불필요한 API 권한을 추가하지 말고, 읽기 데이터 키를 인출 가능한 키로 업그레이드하지 않아야 합니다. 키와 서명은 로그에 기록하지 않아야 하며, 요청 요약 기록만으로도 검증이 충분합니다. 또한 로그 파일은 계정 관련 정보를 보호해야 합니다.
데이터의 완전성은 교차 검증을 통해 확보됩니다.
내보낸 거래 금액, 수수료, 자산 변동 내역을 계좌 보고서, 월별 명세서, 시작 및 종료 잔액과 비교하십시오. 입출금, 보상, 조정 내역은 다른 인터페이스에서 발생할 수 있으며, 거래 기록만으로는 전체 잔액을 설명할 수 없습니다. 설명되지 않은 불일치는 별도로 표시해야 하며, 추가 거래를 조작해서는 안 됩니다. 거래 내역이 인터페이스 보존 기간을 초과한 경우, 공식 보고서 또는 지원 티켓을 참조하십시오.
감사 가능한 데이터 패킷을 출력하십시오.
인터페이스 문서 버전, 내보내기 시간, 계좌 범위, 페이지 매김 매개변수, 행 수, 중복 제거 규칙, 예외 목록을 저장하고, 원본 응답의 안전한 사본을 보관하십시오. 타사 도구의 무결성 주장 또한 이러한 기록을 통해 검증할 수 있어야 합니다. 이 문서는 데이터 처리 목적으로만 사용되며 특정 인터페이스의 상시 가용성을 보장하지 않으며, 세금 관련 결론이나 플랫폼 지급 능력 평가를 자동으로 생성하지 않습니다.