crisphive
예약신규 및 변경된 작업 요청 폴링 (동기화 피드)

신규 및 변경된 작업 요청 폴링 (동기화 피드)

전체 목록을 다시 조회하지 않고도 예약 데이터의 사본을 최신 상태로 유지할 수 있습니다. `since` 커서 시점 또는 그 이후에 상태가 변경된(생성, 상태 전환, 일정 변경, 소프트 삭제/보관) 작업 요청을 가장 오래된 변경부터(updated_at ASC) 정렬하여 반환합니다. 사용 방법: (1) 첫 폴링에서는 `since`를 생략하십시오 — 서버가 커서를 "현재 시점"으로 초기화하고, 항목 없이 `next_since`만 반환합니다. (2) `next_since`를 저장했다가 다음 폴링에서 `since`로 전달하십시오. (3) 반환된 각 항목을 `id` 기준으로 UPSERT하여 저장소에 반영하십시오(서버가 약 5초의 안전 구간을 재스캔하므로 동일한 작업이 다시 나타날 수 있습니다 — 무조건 추가하지 마십시오). (4) `has_more`가 true이면 페이지가 `limit`까지 가득 찼고 이미 대기 중인 변경이 더 있다는 의미입니다 — 즉시 다시 폴링하십시오. 그렇지 않으면 일반 주기(예: 5–15초)만큼 대기하십시오. 이것은 페이지네이션이 아니라 시간 기반 변경 피드입니다. 최초 대량 로드에는 페이지네이션된 GET /job-requests를 사용하고, 이후 실시간 동기화에는 이 엔드포인트를 사용하십시오. 필터(status_keys, customer_id 등)는 피드를 관심 있는 범위로 좁혀 줍니다.

인수

status_keysstringquery선택
쉼표로 구분된 상태 슬러그 목록 — 이 상태에 해당하는 작업의 변경만 반환합니다
prioritystringquery선택
우선순위 필터 (normal|emergency)
customer_idstringquery선택
이 고객의 작업 변경만 반환합니다 (UUID)
technician_idstringquery선택
이 기술자에게 배정된 작업의 변경만 반환합니다 (UUID)
scheduled_fromstringquery선택
시작 필터 (YYYY-MM-DD 또는 RFC3339). 범위는 [from, to)입니다
scheduled_tostringquery선택
종료 필터 (YYYY-MM-DD 또는 RFC3339), 종료값 미포함
sincestringquery선택
이전 응답의 next_since에서 가져온 RFC3339 커서입니다. 첫 폴링에서는 생략하여 커서를 서버 현재 시점으로 초기화하십시오.
limitintegerquery선택
폴링당 최대 변경 수 (기본값 15, 최대 1000). 페이지가 가득 차면 has_more=true입니다.
GET/v1/job-requests/changes
curl -X GET "https://api.crisphive.com/v1/job-requests/changes" \
  -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT"

응답