---
title: 로그 API
description: 소스 값이나 다른 조직의 존재를 드러내지 않고 한도가 있는 소스 오류와 스키마 변경을 읽습니다.
species: reference
---
# 로그 API

로그 읽기에는 `data:read`가 필요합니다. 응답은 bearer 자격 증명의 조직으로 제한되며, 크기에 한도가 있는 최신순 컬렉션을 사용합니다.

## 소스 오류

```endpoint
GET /sources/{id}/errors
```

소스 하나의 최근 오류를 분류하여 반환합니다. 엔드포인트 한도 내에서 `limit`을 사용하세요. 응답에는 자격 증명 값이나 고객 데이터가 포함될 수 있는 원본 대상 메시지를 노출하지 않습니다.

접근할 수 없는 소스는 알 수 없는 ID와 동일하게 `404 source_not_found`를 반환합니다.

## 스키마 변경

```endpoint
GET /schema-changes
```

내용이 있는 최근 스키마 차이를 반환합니다. `source=<source_id>`로 필터링하고 `limit`으로 응답 크기를 제한하세요.

변경 기록에는 영향을 받은 테이블과 추가, 제거, 변경된 열이 포함됩니다. 다음 강제 검사 실행 전에 엄격한 열 선택 구문과 모델 타입 계약을 검토해야 한다는 신호입니다.

## 운영 시 사용

동기화가 최종 실패한 뒤 로그를 폴링하거나 먼저 [동기화 API](/docs/api/sync)로 소스 진행 상황을 추적하세요. 자동화를 위해 사람이 읽는 메시지 텍스트를 파싱하지 마세요. 안정적인 분류, 코드, ID, 타임스탬프가 기계용 인터페이스입니다.

모든 응답에는 `Request-Id`가 포함됩니다. 지원팀에 문의할 때 소스 ID 및 시간 범위와 함께 제공하세요.