문서 메뉴

로그 API#

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

소스 오류#

GET/sources/{id}/errors

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

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

스키마 변경#

GET/schema-changes

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

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

운영 시 사용#

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

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