작업 동기화 상태 목록

get

/cdi/integrations/{integration_id}/job_sync_status

이 엔드포인트를 사용하여 주어진 통합에 대한 과거 동기화 상태 목록을 반환합니다.

note:

이 엔드포인트를 사용하려면 cdi.integration_job_status 권한이 있는 API 키를 생성해야 합니다.

사용량 제한

경로 매개변수

매개변수 필수 데이터 유형 설명

integration_id 필수 문자열 통합 ID.

쿼리 매개변수

이 엔드포인트에 대한 각 호출은 10개 항목을 반환합니다. 10개 이상의 동기화가 있는 통합의 경우 Link 헤더를 사용하여 다음 예제 응답과 같이 다음 페이지에서 데이터를 검색합니다.

매개변수 필수 데이터 유형 설명

cursor 선택 사항 문자열 동기화 상태의 페이지 매김을 결정합니다.

요청 예시

커서 없음

curl --location --request GET 'https://rest.iad-03.braze.com/cdi/integrations/00000000-0000-0000-0000-000000000000/job_sync_status' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

커서 포함

curl --location --request GET 'https://rest.iad-03.braze.com/cdi/integrations/00000000-0000-0000-0000-000000000000/job_sync_status?cursor=c2tpcDow' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY'

응답

성공 응답의 예

200 상태 코드는 다음과 같은 응답 본문을 반환할 수 있습니다.

note:

총 동기화가 10개 이하인 경우 Link 헤더가 존재하지 않습니다. 커서가 없는 통화의 경우 prev가 표시되지 않습니다. 항목의 마지막 페이지를 보면 next가 표시되지 않습니다.

Link: </cdi/integrations/00000000-0000-0000-0000-000000000000/job_sync_status?cursor=c2tpcDow>; rel="prev",</cdi/integrations00000000-0000-0000-0000-000000000000/job_sync_status?cursor=c2tpcDoxMDA=>; rel="next"

{
  "results": [
    {
        "job_status": (string) status of the sync, see below for explanation of different statuses,
        "sync_start_time": (string) time the sync started in ISO 8601,
        "sync_finish_time": (string) time the sync finished in ISO 8601,
        "last_timestamp_synced": (string) last UPDATED_AT timestamp processed by the sync in ISO 8601,
        "rows_synced": (integer) number of rows successfully synced to Braze,
        "rows_failed_with_errors": (integer) number of rows failed because of errors,
    },
  ],
  "message": "success"
}

직업 상태 설명

running 작업이 현재 실행 중입니다.

success 모든 행이 성공적으로 동기화되었습니다.

partial 일부 행이 오류로 인해 동기화되지 않았습니다.

error 행이 동기화되지 않았습니다.

config_error 통합 구성에 오류가 있었습니다. 통합 설정을 확인하십시오.

문제 해결

다음 표에는 반환될 수 있는 오류와 관련 문제 해결 단계가 나와 있습니다.

오류 문제 해결

400 Invalid cursor cursor 주소가 유효한지 확인합니다.

400 Invalid integration ID integration_id 주소가 유효한지 확인합니다.

추가 상태 코드 및 관련 오류 메시지는심각한 오류 및 응답을 참조하세요.

GitHub 에서 이 페이지를 편집합니다.

이 페이지가 얼마나 도움이 되었나요?

GitHub 에서 이 페이지를 편집합니다.

New Stuff!