현재 Zendesk는 현재 거의 모든 REST API 엔드포인트에 대해 오프셋 기반 페이지 매김을 제공합니다. 대부분의 소규모 사용 사례(예: 10페이지의 데이터를 초과하지 않는 요청)에서는 괜찮지만 대규모로 사용되면 페이지 오프셋이 높아져 인프라에 부담이 갑니다. 이렇게 오프셋이 높은 요청은 새 페이지가 요청될 때마다 이전 페이지를 모두 먼저 취합해야 하므로 응답 시간이 오래되고 성능이 저하됩니다.
고객에게 더 나은 개발자 경험과 더 빠른 성능을 제공하기 위해 곧 주로 커서 기반 페이지 매김으로 마이그레이션하여 매우 높은 페이지 오프셋 요청에 제한을 구현할 예정입니다.
- 커서 기반 페이지 매김이란
- 이러한 변경 방법 및 이유는 무엇인가요?
- 오프셋 기반 페이지 매김의 한도
- 이러한 변경 내용을 적용하려면 어떻게 해야 하나요?
- 어떤 엔드포인트가 지원되나요?
커서 기반 페이지 매김이란
커서 기반 페이지 매김은 데이터 집합의 특정 항목에 대한 포인터로 진행 상황을 표시하여 작동합니다. 기본적으로 후속 요청에 커서를 제공함으로써 데이터 집합에서 다음 항목 배치를 요청할 수 있는 일종의 북마크 역할을 합니다. 다음 페이지에서 항목 전체를 반복하는 대신 이전 응답에서 주어진 커서를 제공합니다. 이렇게 하면 많은 양의 결과를 더 빨리 얻을 수 있는 이점이 있습니다.
이러한 변경 방법 및 이유는 무엇인가요?
가까운 시일 내에 Zendesk는 대규모 API 사용을 향상시키는 변경을 할 예정입니다. 여기에는 2021년 내내 대다수의 엔드포인트가 추가되기 전의 Users, 티켓 및 태그엔드포인트를 살펴보겠습니다.
오프셋 기반 페이지 매김은 상당히 제한된 범위와 수준으로 계속 제공될 것입니다. 여기에는 오프셋이 매우 큰 요청(1,000페이지 이상의 요청)을 제한하는 것이 포함되며, 이는 Zendesk API의 많은 사용자에게 가장 긍정적인 다양한 결과를 가져다 줍니다.
커서 기반 페이지 매김의 이점은 다음과 같습니다.
- 더 이상 매우 높은 페이지 번호의 요청을 할 때 발생하는 매우 긴 시간 초과로 인해 문제가 발생하지 않습니다. 이로써 페이지별로 전체 리소스 집합을 검토해야 하는 거의 모든 연동 서비스에서 성능이 더 빨라집니다.
- 커서 기반 페이지 매김을 사용하는 요청이 더 이상 서비스 중단에서 인프라의 부담으로 인한 인시던트에 이르기까지 높은 페이지 오프셋 기반 페이지 매김이 나타내는 인프라 위험을 초래하지 않습니다.
- 오프셋 기반 페이지 매김을 사용하여 전체 리소스 집합을 내보내는 연동 서비스의 경우, 커서 기반 페이지 매김으로 전환하는 것이 연동 서비스를 준비하는 데 최소한의 재작업만 필요하므로 비교적 쉽게 커서 기반 페이지 매김으로 전환할 수 있습니다. Zendesk Insights를 사용하는 대신 다음_페이지 매개변수로, 연동 서비스가 새 페이지에커서매개변수를 사용할 수 있습니다.
자세한 비교는이 페이지를 참조하세요 .
오프셋 기반 페이지 매김의 한도
Zendesk는 커서 기반 페이지 매김을 사용할 수 있는 모든 트래픽이 오프셋 기반 페이지 매김에서 전환되기를 원합니다.
이러한 이동을 장려하기 위해 2021년 9월 15일부터Zendesk는 1,000페이지 (100,000페이지)를 초과하는 요청에 대해 호출 빈도 제한을 구현합니다.리소스 참조). 1,000페이지가 넘는 모든 요청에 대해 계정은 다음으로 제한됩니다. 분당 10개 요청.
인프라에 과도한 부담을 주는 요청의 속도를 늦출 수는 없습니다. 1,000페이지가 넘는 요청이 분당 10번보다 빠른 경우에는 429 응답이 제공되며 요청을 나중에 다시 시도해야 합니다. 이 오류 메시지에는 사용자가 다음 요청을 제출하고 검색을 계속할 수 있을 때까지 남은 시간도 표시됩니다.
커서 기반 페이지 매김을 사용하여 수행된 요청에는 유사한 제한이 없으며 페이지 오프셋이 높은 요청보다 더 빠르게 수행합니다.
이러한 변경 내용을 적용하려면 어떻게 해야 하나요?
커서 기반 페이지 매김으로 전환할 계획을 세우는 것이 좋습니다. 가능한 빨리 하세요. 커서 기반 페이지 매기기를 사용하여 목록 페이지 매기기를참조하세요. 변경 내용을 살펴보고 내부에서 변경 내용을 논의한 후 다음 몇 가지 항목을 검토하시기 바랍니다.
- 오프셋 기반 페이지 매김을 계속 사용할 연동 서비스가 Zendesk의 제한내에서 그러한 방식을 사용하도록 해야 합니다.
- 사용 가능한 모든 데이터를 수집하거나 변경 내용만 보고하는 용도로 특히 API를 사용하는 연동 서비스 부분을 검토하세요. 일반적으로 데이터 웨어하우징을 위한 이상적인 장소입니다.
- 엔드포인트를 사용하여 모든 이용 가능한 데이터를 사용하는 경우에는 커서 기반 페이지 매김으로 전환하는 작업을 시작하세요.
- API를 사용하여 일별 변경 사항에 대해 보고하려면증분 API를 사용하시기 바랍니다. , 이 사용 사례에 대한 많은 양의 모든 관련 데이터를 허용합니다. 초기 내보내기에 커서 기반 페이지 매김을 사용한 다음 증분 API로 전환하여 변경 내용을 캡처하면 관련 데이터를 수집하는 데 필요한 호출을 상당히 줄일 수 있습니다.
- 현재 여러 페이지에 병렬로 요청하는 경우에는 병렬 페이지 매김이 지원되지 않아 인프라에 부담을 주기 때문에 위의 증분 옵션을 고려해 보세요.
어떤 엔드포인트가 지원되나요?
커서 페이지 페이지 매김을 지원하는 엔드포인트 목록은 오프셋 기반 페이지 매김 제한에 대한 공지 사항에서CBP 기능이 있는 엔드포인트를참조하세요.
이 내용을 검토한 후 추가 질문이나 우려 사항이 있으시면 귀하 및 엔지니어링 및 연동 팀과 논의하시기 바랍니다.
시간을 내어 다음 사항을 검토해 주셔서 감사합니다. 가까운 시일 내에 귀사의 고객에게 더 나은 서비스를 제공할 수 있도록 더 훌륭하고, 빠르고, 확장 가능한 도구를 만들 수 있기를 바랍니다.
번역 고지 사항: 본 문서는 콘텐츠에 대한 기본적인 이해를 제공하기 위해 자동 번역 소프트웨어를 사용하여 번역되었습니다. 정확한 번역을 제공하고자 합당한 노력을 기울였으나 Zendesk는 번역의 정확성을 보장하지 않습니다.
번역된 문서에 포함된 정보의 정확성과 관련하여 질문이 있으시면 문서의 공식 버전인 영문 버전을 참조하시기 바랍니다.