요청은 저장된 데이터를 읽습니다
CPI, GDP, 노동 또는 무역 데이터를 요청하면 Narwhal은 데이터베이스에서 최근 승인 발표를 읽습니다. 요청을 처리하는 동안 공식 제공 기관을 호출하지 않습니다.
이를 통해 고객 응답 시간과 새 발표를 가져와 확인하는 작업이 분리됩니다. 출처 웹사이트가 느려도 모든 고객 요청이 해당 웹사이트를 기다리지는 않으며 출처 확인만 지연될 수 있습니다.
발행본은 전체 단위로 통과해야 합니다
새 데이터는 완전한 발표가 검증을 통과한 후에만 공개됩니다. 업데이트 절차는 의도적으로 단순합니다:
- 예약된 워커가 공식 소스를 확인합니다.
- Narwhal은 발표를 가져와 식별 정보, 기간, 필수 필드 및 완전성을 확인합니다.
- 정규화된 관측값과 출처 근거가 함께 저장됩니다.
- 완전한 발표는 필요한 모든 확인을 통과한 후에만 현재 고객 버전이 됩니다.
검사에 실패해도 정상 데이터는 삭제되지 않습니다
공식 사이트가 시간 초과될 수 있습니다. 파일이 불완전하게 도착할 수 있고 형식이 변경될 수 있습니다. 후보 발표가 검증에 실패하면 Narwhal은 마지막 승인 발표를 계속 제공합니다. 값을 0으로 바꾸거나 실패한 발표의 일부를 이전 발표와 합치지 않습니다.
Narwhal이 안전하게 제공할 수 있는 발표가 없으면 API는 결과를 만들어내는 대신 문서화된 503 오류를 반환합니다.
날짜를 있는 그대로 읽기
period 필드는 관측값이 다루는 월, 분기 또는 연도를 나타냅니다. released_on 필드는 해당 발표가 제공하는 공식 발표일입니다.
공개 베타는 Narwhal 수집 타임스탬프를 공개하지 않으며 출처 발표부터 API 게시까지의 고정 지연 시간을 약속하지 않습니다. 이 날짜는 경제 관측값과 공식 발표를 나타내며 API 호출 속도를 나타내지 않습니다.
수정본은 이전 값을 대체합니다
경제 기관은 발표된 수치를 정기적으로 수정합니다. 수정된 공식 발표가 동일한 확인을 통과하면 해당 기간에 이전에 저장된 값을 대체할 수 있습니다. 애플리케이션은 공식 경제 데이터를 수정될 수 있는 발표 데이터로 취급해야 하며 변경 불가능한 이벤트 로그로 취급해서는 안 됩니다.
출처 및 레퍼런스
게시됨 마지막 검토일 .