Ankündigung am Bereitstellung am (gestaffelt)
22. Mai 2023

20. Mai 2024 – Regionen außerhalb der EU – ABGESCHLOSSEN

09. September 2024 – EU-Region – ABGESCHLOSSEN

 

Zendesk bietet für die meisten API-Endpunkte sowohl Offset-basierte Paginierung (OBP) als auch Cursor-basierte Paginierung (CBP). CBP bietet gegenüber OBP viele Vorteile und wird in naher Zukunft die primäre Paginierungsmethode bei Zendesk sein. Um unseren Kunden ein besseres und schnelleres Erlebnis zu bieten, ergreifen wir Schritte, um den Umstieg auf CBP zu fördern. Angefangen mit der Einführung strengerer Limits für OBP-Anfragen mit hohem Offset.

Diese Ankündigung beantwortet die folgenden Fragen:

  • Was ändert sich?
  • Warum nimmt Zendesk diese Änderung vor?
  • Was muss ich tun?

Was ändert sich?

Ab dem 20. Mai 2024 führen OBP-Anfragen über die ersten 10.000 Datensätze (100 Seiten) zu einer Fehlermeldung: „400 Ungültige Anfrage“ Um Datensätze mit mehr als 10.000 Datensätzen anzufordern, müssen Kunden auf CBP umsteigen.

OBP-Anfragen für weniger als 10.000 Datensätze sind ebenso wenig betroffen wie Anfragen, die nach dem CBP-Modell eingereicht werden. 

Warum nimmt Zendesk diese Änderung vor?

Wir nehmen diese Änderung im Rahmen unserer vorherigen Ankündigung vor, in der wir die Übernahme von CBP empfehlen und Kunden dazu auffordern, die Umstellung so bald wie möglich vorzunehmen.

Die Cursorbasierte Paginierung ist für unsere Kunden schneller und effizienter. Außerdem wird die Zendesk-Infrastruktur weniger belastet und die Stabilität und Zuverlässigkeit erhöht. Als Erstes beschränken wir die Offset-basierten Paginierungsfunktionen auf einer relativ hohen Ebene, damit die Umstellung mit minimaler Unterbrechung der aktuellen API-Nutzung erfolgen kann. 

Was muss ich tun?

Zendesk empfiehlt Kunden nachdrücklich, vor dem 20. Mai 2024 auf die Cursor-basierte Paginierung umzusteigen. Wenn Sie nicht wissen, welche Integrationen oder Anwendungen den Höchstwert möglicherweise überschreiten, sollten Sie sich mit Ihrem Team, das für die Verwaltung der Zendesk-Integrationen und -Apps zuständig ist, besprechen, um herauszufinden, was diese Änderung für Sie bedeutet.

Zendesk wird auch weiterhin Offset-Paginierung bieten, aber in naher Zukunft wird die Seitentiefe stark eingeschränkt, um die Übernahme der leistungsstarken Cursor-Paginierung zu fördern und die Antwortzeiten auf Ihre Anfragen zu verbessern. 

Wenn Sie Fragen haben oder zusätzlichen Support benötigen, wenden Sie sich an uns. Wir helfen Ihnen gerne weiter. Sie können über das Web Widget mit uns Kontakt aufnehmen.

 

Wir sorgen für einen nahtlosen Übergang für alle Benutzer, indem wir den Rollout phasenweise durchführen. Kontoänderungen in der EU-Region sollen innerhalb von drei Monaten veröffentlicht werden – am 9. September 2024. 

 

Für Client-Bibliotheken/SDKs verfügbare Aktualisierungen

Zendesk hat seinen offiziellen Ruby-Client aktualisiert und eine Partnerschaft mit Entwicklern von Community-SDKs geschlossen, um CBP-Support zu bieten. Wenn Sie eine dieser Bibliotheken verwenden, führen Sie einen Test durch und installieren Sie die neueste Version.

Bibliothek Nützliche Anweisungen
Ruby

Zendesk-API-Client

>=3.0.4 unterstützt Cursor-Paginierung

Weitere Informationen finden Sie unter Allgemeine Verwendung im Wiki.
Python

Zen Py

>=v2.0.34 unterstützt Cursor-Paginierung

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

Knoten Zendesk

>= v3.0.2 unterstützt Cursor-Paginierung. Verweisen Sie hier auf das Release-Tag.

npm update node-zendesk
Java

Zendesk Java Client

>= v0.24.1 unterstützt Cursor-Paginierung. Verweisen Sie hier auf das Release-Tag.

Verwenden von Maven
PHP

ZendeskAPI PHP-Client

>=3.0.01 unterstützt Cursor-Paginierung

composer require zendesk/zendesk_api_client_php:^3.0.1

Weitere Informationen finden Sie in der Upgrade-Guide.
MS BI Connector

Der neue, verbesserte Zendesk Data Connector kann jetzt Datensätze > 1000 Zeilen abrufen und nutzt das Cursor-Modell zum schnelleren Abrufen von Daten.

Weitere Informationen zur Verwendung des neuesten Connectors finden Sie im Migrationsleitfaden .
Go Lang

go-zendesk

>=v0.18.0

Weitere Informationen finden Sie im Upgrade-Guide
C#

ZendeskApiClient

>=7.0.7 unterstützt Cursor-Paginierung 

Weitere Informationen zur Verwendung der Cursor-basierten Paginierung finden Sie im Abschnitt zur README.

 

CBP-fähige Endpunkte

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

 

 

Produkt Endpunkt
Help Center /hc/api/v2/incremental/articles
Help Center /hc/api/v2/articles/attachments/:id
Help Center /hc/api/v2/articles/labels
Help Center /hc/api/v2/articles/labels
Help Center /hc/api/v2/articles/:article_id/translations/missing
Help Center /hc/api/v2/articles/:article_id/translations
Help Center /hc/api/v2/articles/:article_id/translations/:id
Help Center /hc/api/v2/categories/:category_id/translations/missing
Help Center /hc/api/v2/categories/:category_id/translations
Help Center /hc/api/v2/categories/:category_id/translations/:id
Help Center /hc/api/v2/user_segments/applicable
Help Center /hc/api/v2/user_segments/:user_segment_id/sections
Help Center /hc/api/v2/user_segments/:user_segment_id/topics
Help Center /hc/api/v2/user_segments
Help Center /hc/api/v2/user_segments/:id
Help Center /hc/api/v2/sections/:section_id/translations/missing
Help Center /hc/api/v2/sections/:section_id/translations
Help Center /hc/api/v2/sections/:section_id/translations/:id
Help Center /hc/api/v2(/:locale)/articles/:article_id/attachments/:scope
Help Center /hc/api/v2(/:locale)/articles/:article_id/attachments
Help Center /hc/api/v2(/:locale)/articles/:article_id/attachments/:id
Help Center /hc/api/v2(/:locale)/articles/:article_id/labels
Help Center /hc/api/v2(/:locale)/articles/:article_id/comments/:comment_id/votes
Help Center /hc/api/v2(/:locale)/articles/:article_id/comments
Help Center /hc/api/v2(/:locale)/articles/:article_id/comments/:id
Help Center /hc/api/v2(/:locale)/articles/:article_id/votes
Help Center /hc/api/v2(/:locale)/articles/:article_id/subscriptions
Help Center /hc/api/v2(/:locale)/articles/:article_id/subscriptions/:id
Help Center /hc/api/v2(/:locale)/articles
Help Center /hc/api/v2(/:locale)/articles/:id
Help Center /hc/api/v2(/:locale)/categories/:category_id/articles
Help Center /hc/api/v2(/:locale)/categories/:category_id/sections
Help Center /hc/api/v2(/:locale)/categories
Help Center /hc/api/v2(/:locale)/categories/:id
Help Center /hc/api/v2(/:locale)/sections/:section_id/articles
Help Center /hc/api/v2(/:locale)/sections/:section_id/subscriptions
Help Center /hc/api/v2(/:locale)/sections/:section_id/subscriptions/:id
Help Center /hc/api/v2(/:locale)/sections
Help Center /hc/api/v2(/:locale)/sections/:id
Help Center /hc/api/v2/community/posts/:post_id/comments/:comment_id/votes
Help Center /hc/api/v2/community/posts/:post_id/comments
Help Center /hc/api/v2/community/posts/:post_id/comments/:id
Help Center /hc/api/v2/community/posts/:post_id/subscriptions
Help Center /hc/api/v2/community/posts/:post_id/subscriptions/:id
Help Center /hc/api/v2/community/posts/:post_id/votes
Help Center /hc/api/v2/community/posts
Help Center /hc/api/v2/community/posts/:id
Help Center /hc/api/v2/community/topics/:topic_id/subscriptions
Help Center /hc/api/v2/community/topics/:topic_id/subscriptions/:id
Help Center /hc/api/v2/community/topics/:topic_id/posts
Help Center /api/v2/community/topics
Help Center /hc/api/v2/community/topics/:id
Help Center /hc/api/v2/community/users/:user_id/posts
Help Center /hc/api/v2/community/users/{user_id}/comments
Help Center /hc/api/v2/users/:benutzer-id/articles
Help Center /hc/api/v2/users/:user_id/subscriptions
Help Center /hc/api/v2/users/:user_id/user_subscriptions
Help Center /hc/api/v2/users/:user_id/comments
Help Center /hc/api/v2/users/:user_id/votes
Help Center /hc/api/v2/users/:user_id/user_segments
Help Center /hc/api/v2/votes
Help Center /hc/api/v2/votes/:id
Powered by Zendesk