발표일 출시일(시차 적용)
2023년 5월 22일

2024년 5월 20일 - 비 EU 지역 - 완료

2024년 9월 9일 - EU 지역 - 완료

 

Zendesk는 현재 대부분의 API 엔드포인트에 대해 오프셋 기반 페이지 매김(OPP)과 커서 기반 페이지 매김(CBP)을 모두 제공합니다. CBP는 OBP에 비해 많은 장점을 제공하며 곧 Zendesk에서 제공하는 주요 페이지 매김 방법이 될 것입니다. Zendesk는 고객에게 더 훌륭하고 신속한 경험을 제공하기 위한 노력으로 CBP로의 전환을 장려하는 조치를 취하고 있습니다. 그 일환으로 오프셋이 많은 OBP 요청에 대한 한도를 더욱 엄격히 지정하였습니다.

본 공지에서는 다음 질문에 대한 답변을 제공합니다.

  • 무엇이 변경되나요?
  • Zendesk에서 이러한 변경을 하는 이유는 무엇인가요?
  • 어떻게 해야 하나요?

무엇이 변경되나요?

2024년 5월 20일부터 처음 10,000개 레코드(100페이지)에 대한 OBP 요청이 발생하면 다음과 같은 오류 메시지가 표시됩니다. ‘400 잘못된 요청’ 레코드가 10,000개를 초과하는 데이터 집합을 요청하려면 고객은 CBP로 전환을 실시해야 합니다.

10,000개 미만의 레코드에 대한 OBP 요청은 영향을 받지 않으며, CBP 모델을 사용하여 만들어진 요청도 영향을 받지 않습니다. 

Zendesk에서 이러한 변경을 하는 이유

Zendesk는 CBP의 채택을 권장하고 고객이 최대한 신속히 전환하도록 권장하는 이전 발표에 따라 이러한 변경을 실시하고 있습니다.

커서 기반 페이지 매김으로 고객이 더욱 빠르고 효율적으로 활용할 수 있습니다. 또한 Zendesk 인프라에 대한 부담을 줄여 주며 안정성을 높여 줍니다. 그 일환으로 우선 현재 API 사용에 미치는 영향을 최소화하면서 오프셋 기반 페이지 매김 기능을 비교적 높은 수준으로 제한하였습니다. 

어떻게 해야 하나요?

Zendesk는 2024년 5월 20일 전에 고객에게 커서 기반 페이지 매김으로 전환할 것을 적극 권장합니다. 어떤 연동 서비스 또는 애플리케이션이 한도를 초과하는지 모르는 경우에는 Zendesk 연동 서비스 및 앱 관리를 담당하는 팀과 협력하여 이와 같은 변경이 무엇을 의미하는지 알아보고 결정하시기 바랍니다.

Zendesk는 오프셋 페이지 매김을 계속 제공하지만 곧 페이지 깊이를 크게 제한하여 고성능 커서 페이지 매김을 도입하도록 장려하고 요청에 대한 응답 시간을 개선할 것입니다. 

질문이 있거나 추가적인 지원이 필요하신 경우 문의하시면 성심껏 도와드리겠습니다. 웹 위젯을 통해 Zendesk에 연락하실 수 있습니다.

 

3개월 후인 2024년 9월 9일에 EU 지역 계정 변경 사항이 릴리스될 예정이며, 시차를 두고 배포함으로써 모든 사용자가 원활하게 전환할 수 있도록 하고 있습니다. 

 

클라이언트 라이브러리/SDK에 사용 가능한 업데이트

Zendesk는 공식 Ruby 클라이언트를 업데이트하고 커뮤니티 SDK 개발자들과 협력하여 CBP 지원을 제공합니다. 이러한 라이브러리 중 하나를 사용하고 있다면 검토 및 테스트한 후 최신 버전으로 업데이트하세요.

라이브러리 유용한 지침
Ruby

Zendesk API 클라이언트

>=3.0.4는 커서 페이지 매김을 지원합니다.

Wiki의 일반적인 사용법을 참조하세요.
Python

Zen Py

>=v2.0.34는 커서 페이지 매김을 지원합니다.

pip install zenpy --upgrade
Or 
pip install zenpy==2.0.46(latest version as of this writing)
NodeJS

Node Zendesk

>=v3.0.2는 커서 페이지 매김을 지원합니다. 여기에서 릴리스 태그를 참조하세요.

npm update node-zendesk
Java

Zendesk Java 클라이언트

>= v0.24.1은 커서 페이지 매김을 지원합니다. 여기에서 릴리스 태그를 참조하세요.

Mven 사용
PHP

ZendeskAPI PHP 클라이언트

>= 3.0.01은 커서 페이지 매김을 지원합니다.

composer require zendesk/zendesk_api_client_php:^3.0.1

업그레이드 가이드를 참조하세요.
MS BI 커넥터

새롭게 개선된 Zendesk 데이터 커넥터는 이제 1000행이 넘는 레코드를 가져오는 기능을 제공하며 더 빠른 데이터 검색을 위해 커서 모델을 사용합니다.

최신 커넥터 사용 방법은 마이그레이션 가이드를 참조하세요.
Go Lang

go-zendesk

>=v0.18.0

업그레이드 설명서를 참조하세요.
C#

ZendeskApiClient

>= 7.0.7은 커서 페이지 매김을 지원합니다. 

커서 기반 페이지 매김 사용 방법에 대한 README 섹션을 참조하세요.

 

CBP 기능이 있는 엔드포인트

제품 엔드포인트
통합 티켓 관리 /api/v2/activities
통합 티켓 관리 /api/v2/audit_logs
통합 티켓 관리 /api/v2/automations
통합 티켓 관리 /api/v2/automations/active
통합 티켓 관리 /api/v2/brands
통합 티켓 관리 /api/v2/custom_objects/:custom_object_key/fields
통합 티켓 관리 /api/v2/custom_objects/:custom_object_key/records
통합 티켓 관리 /api/v2/custom_objects/:custom_object_key/records/autocomplete
통합 티켓 관리 /api/v2/custom_objects/:custom_object_key/records/search
통합 티켓 관리 /api/v2/custom_objects/:custom_object_key/triggers
통합 티켓 관리 /api/v2/custom_objects/:custom_object_key/triggers/active
통합 티켓 관리 /api/v2/deleted_tickets
통합 티켓 관리 /api/v2/deleted_users
통합 티켓 관리 /api/v2/deletion_schedules
통합 티켓 관리 /api/v2/dynamic_content/items
통합 티켓 관리 /api/v2/dynamic_content/items/:item_id/variants
통합 티켓 관리 /api/v2/end_users/:end_user_id/identities
통합 티켓 관리 /api/v2/group_memberships
통합 티켓 관리 /api/v2/group_memberships/assignable
통합 티켓 관리 /api/v2/groups
통합 티켓 관리 /api/v2/groups/:group_id/memberships
통합 티켓 관리 /api/v2/groups/:group_id/memberships/assignable
통합 티켓 관리 /api/v2/groups/:group_id/users
통합 티켓 관리 /api/v2/groups/assignable
통합 티켓 관리 /api/v2/groups/available_agents
통합 티켓 관리 /api/v2/incremental/ticket_metric_events
통합 티켓 관리 /api/v2/job_statuses
통합 티켓 관리 /api/v2/macros
통합 티켓 관리 /api/v2/macros/active
통합 티켓 관리 /api/v2/macros/groups
통합 티켓 관리 /api/v2/organization_fields
통합 티켓 관리 /api/v2/organization_memberships
통합 티켓 관리 /api/v2/organization_subscriptions
통합 티켓 관리 /api/v2/organizations
통합 티켓 관리 /api/v2/organizations/:organization_id/organization_memberships
통합 티켓 관리 /api/v2/organizations/:organization_id/requests
통합 티켓 관리 /api/v2/organizations/:organization_id/subscriptions
통합 티켓 관리 /api/v2/organizations/:organization_id/tickets
통합 티켓 관리 /api/v2/organizations/:organization_id/users
통합 티켓 관리 /api/v2/problems
통합 티켓 관리 /api/v2/recipient_addresses
통합 티켓 관리 /api/v2/requests
통합 티켓 관리 /api/v2/requests/:request_id/comments
통합 티켓 관리 /api/v2/requests/ccd
통합 티켓 관리 /api/v2/requests/open
통합 티켓 관리 /api/v2/requests/solved
통합 티켓 관리 /api/v2/satisfaction_ratings
통합 티켓 관리 /api/v2/search/export
통합 티켓 관리 /api/v2/sessions
통합 티켓 관리 /api/v2/skips
통합 티켓 관리 /api/v2/suspended_tickets
통합 티켓 관리 /api/v2/tags
통합 티켓 관리 /api/v2/:target_type/:target_id/relationship_fields/:field_id/:source_type
통합 티켓 관리 /api/v2/ticket_audits
통합 티켓 관리 /api/v2/ticket_content_pins
통합 티켓 관리 /api/v2/ticket_fields
통합 티켓 관리 /api/v2/ticket_fields/:ticket_field_id/options
통합 티켓 관리 /api/v2/ticket_metrics
통합 티켓 관리 /api/v2/tickets
통합 티켓 관리 /api/v2/tickets/:ticket_id/audits
통합 티켓 관리 /api/v2/tickets/:ticket_id/comments
통합 티켓 관리 /api/v2/tickets/:ticket_id/incidents
통합 티켓 관리 /api/v2/tickets/:ticket_id/skips
통합 티켓 관리 /api/v2/trigger_categories
통합 티켓 관리 /api/v2/triggers
통합 티켓 관리 /api/v2/triggers/active
통합 티켓 관리 /api/v2/user_fields
통합 티켓 관리 /api/v2/user_fields/:user_field_id/options
통합 티켓 관리 /api/v2/users
통합 티켓 관리 /api/v2/users/:user_id/group_memberships
통합 티켓 관리 /api/v2/users/:user_id/groups
통합 티켓 관리 /api/v2/users/:user_id/identities
통합 티켓 관리 /api/v2/users/:user_id/organization_memberships
통합 티켓 관리 /api/v2/users/:user_id/organization_subscriptions
통합 티켓 관리 /api/v2/users/:user_id/organizations
통합 티켓 관리 /api/v2/users/:user_id/requests
통합 티켓 관리 /api/v2/users/:user_id/sessions
통합 티켓 관리 /api/v2/users/:user_id/skips
통합 티켓 관리 /api/v2/users/:user_id/tickets/assigned
통합 티켓 관리 /api/v2/users/:user_id/tickets/ccd
통합 티켓 관리 /api/v2/users/:user_id/tickets/requested
통합 티켓 관리 /api/v2/views
통합 티켓 관리 /api/v2/views/:id/execute
통합 티켓 관리 /api/v2/views/:id/tickets

 

 

제품 엔드포인트
헬프 센터 /hc/api/v2/incremental/articles
헬프 센터 /hc/api/v2/articles/attachments/:id
헬프 센터 /hc/api/v2/articles/labels
헬프 센터 /hc/api/v2/articles/labels/:id
헬프 센터 /hc/api/v2/articles/:article_id/translations/missing
헬프 센터 /hc/api/v2/articles/:article_id/translations
헬프 센터 /hc/api/v2/articles/:article_id/translations/:id
헬프 센터 /hc/api/v2/categories/:category_id/translations/missing
헬프 센터 /hc/api/v2/categories/:category_id/translations
헬프 센터 /hc/api/v2/categories/:category_id/translations/:id
헬프 센터 /hc/api/v2/user_segments/applicable
헬프 센터 /hc/api/v2/user_segments/:user_segment_id/sections
헬프 센터 /hc/api/v2/user_segments/:user_segment_id/topics
헬프 센터 /hc/api/v2/user_segments
헬프 센터 /hc/api/v2/user_segments/:id
헬프 센터 /hc/api/v2/sections/:section_id/translations/missing
헬프 센터 /hc/api/v2/sections/:section_id/translations
헬프 센터 /hc/api/v2/sections/:section_id/translations/:id
헬프 센터 /hc/api/v2(/:locale)/articles/:article_id/attachments/:scope
헬프 센터 /hc/api/v2(/:locale)/articles/:article_id/attachments
헬프 센터 /hc/api/v2(/:locale)/articles/:article_id/attachments/:id
헬프 센터 /hc/api/v2(/:locale)/articles/:article_id/labels
헬프 센터 /hc/api/v2(/:locale)/articles/:article_id/comments/:comment_id/votes
헬프 센터 /hc/api/v2(/:locale)/articles/:article_id/comments
헬프 센터 /hc/api/v2(/:locale)/articles/:article_id/comments/:id
헬프 센터 /hc/api/v2(/:locale)/articles/:article_id/votes
헬프 센터 /hc/api/v2(/:locale)/articles/:article_id/subscriptions
헬프 센터 /hc/api/v2(/:locale)/articles/:article_id/subscriptions/:id
헬프 센터 /hc/api/v2(/:locale)/articles
헬프 센터 /hc/api/v2(/:locale)/articles/:id
헬프 센터 /hc/api/v2(/:locale)/categories/:category_id/articles
헬프 센터 /hc/api/v2(/:locale)/categories/:category_id/sections
헬프 센터 /hc/api/v2(/:locale)/categories
헬프 센터 /hc/api/v2(/:locale)/categories/:id
헬프 센터 /hc/api/v2(/:locale)/sections/:section_id/articles
헬프 센터 /hc/api/v2(/:locale)/sections/:section_id/subscriptions
헬프 센터 /hc/api/v2(/:locale)/sections/:section_id/subscriptions/:id
헬프 센터 /hc/api/v2(/:locale)/sections
헬프 센터 /hc/api/v2(/:locale)/sections/:id
헬프 센터 /hc/api/v2/community/posts/:post_id/comments/:comment_id/votes
헬프 센터 /hc/api/v2/community/posts/:post_id/comments
헬프 센터 /hc/api/v2/community/posts/:post_id/comments/:id
헬프 센터 /hc/api/v2/community/posts/:post_id/subscriptions
헬프 센터 /hc/api/v2/community/posts/:post_id/subscriptions/:id
헬프 센터 /hc/api/v2/community/posts/:post_id/votes
헬프 센터 /hc/api/v2/community/posts
헬프 센터 /hc/api/v2/community/posts/:id
헬프 센터 /hc/api/v2/community/topics/:topic_id/subscriptions
헬프 센터 /hc/api/v2/community/topics/:topic_id/subscriptions/:id
헬프 센터 /hc/api/v2/community/topics/:topic_id/posts
헬프 센터 /hc/api/v2/community/topics
헬프 센터 /hc/api/v2/community/topics/:id
헬프 센터 /hc/api/v2/community/users/:user_id/posts
헬프 센터 /hc/api/v2/community/users/:user_id/comments
헬프 센터 /hc/api/v2/users/:user_id/articles
헬프 센터 /hc/api/v2/users/:user_id/subscriptions
헬프 센터 /hc/api/v2/users/:user_id/user_subscriptions
헬프 센터 /hc/api/v2/users/:user_id/comments
헬프 센터 /hc/api/v2/users/:user_id/votes
헬프 센터 /hc/api/v2/users/:user_id/user_segments
헬프 센터 /hc/api/v2/votes
헬프 센터 /hc/api/v2/votes/:id
Zendesk 제공