Fecha de anuncio | Implementación (escalonada) |
22 de mayo de 2023 |
20 de mayo de 2024 - Regiones fuera de la UE - COMPLETADO 9 de septiembre de 2024 - Región de la UE - COMPLETADO |
Zendesk ofrece actualmente paginación basada en desfase (OBP) y paginación basada en cursor (CBP) para la mayoría de los extremos de API. La CBP ofrece muchas ventajas sobre OBP y será el método principal de paginación ofrecido en Zendesk en un futuro cercano. En un esfuerzo por proporcionar una experiencia mejor y más rápida a nuestros clientes, estamos tomando medidas para fomentar una transición a la CBP, comenzando con la introducción de límites más estrictos para las solicitudes OBP de alto desfase.
Este anuncio responde las siguientes preguntas:
¿Qué va a cambiar?
A partir del 20 de mayo de 2024, las solicitudes OBP que superen los primeros 10 000 registros (100 páginas) darán lugar a un mensaje de error: “400 Bad Request.” Para solicitar conjuntos de datos de más de 10.000 registros, los clientes tendrán que hacer la transición a la CBPl.
Las solicitudes de OBP de menos de 10.000 registros no se verán afectadas, ni las solicitudes realizadas usando el modelo de CBP.
¿Por qué va a hacer este cambio Zendesk?
Estamos haciendo este cambio de acuerdo con nuestro anuncio anterior en el que se recomendaba la adopción de la tecnología de base de datos y alentamos a los clientes a hacer el cambio lo antes posible.
La paginación basada en cursor es más rápida y más eficiente para nuestros clientes. También reduce la presión sobre la infraestructura de Zendesk y aumenta la estabilidad y la fiabilidad. Como primer paso, estamos limitando las capacidades de paginación basada en desfase a un nivel relativamente alto, para que la transición pueda tener lugar con una interrupción mínima en el uso actual de la API.
¿Qué debo hacer?
Zendesk recomienda encarecidamente a los clientes que hagan la transición a la paginación basada en cursor antes del 20 de mayo de 2024. Si no sabe qué integraciones o aplicaciones pueden estar superando el límite, le sugerimos trabajar con el equipo responsable de administrar las integraciones y aplicaciones de Zendesk para investigar y determinar qué significa este cambio para usted.
Zendesk seguirá ofreciendo paginación desplazada, pero limitará significativamente la profundidad de la página en un futuro cercano para fomentar la adopción de una paginación del cursor de alto rendimiento y mejorar los tiempos de respuesta para sus solicitudes.
Si tiene preguntas o necesita soporte adicional, comuníquese con nosotros y con gusto le ayudaremos. Puedecontactarnos a través del Web Widget.
Estamos procurando una transición fluida para todos los usuarios al escalonar la implementación, con los cambios en las cuentas de la región de la UE programados para lanzarse dentro de tres meses, el 9 de agosto de 2024.
Actualizaciones disponibles para las bibliotecas cliente y los SDK
Zendesk actualizó su cliente Ruby oficial y se asoció con los desarrolladores de los SDK de la comunidad para proporcionar soporte para la aplicación basada en la comunidad. Si está usando una de estas bibliotecas, revísela, pruebe y actualice a la versión más reciente.
Biblioteca | Instrucciones útiles |
Ruby |
>= 3.0.4 admite la paginación con cursor Consulte Uso general en el wiki. |
Python |
>= v2.0.34 admite la paginación con cursor pip install zenpy --upgrade |
NodeJS |
>= v3.0.2 admite la paginación del cursor. Consulte la etiqueta de la versión aquí. npm update node-zendesk |
Java |
>= v0.24.1 Admite la paginación con cursor Consulte la etiqueta de la versión aquí. Uso de Maven |
PHP |
>= 3.0.01 admite la paginación con cursor composer require zendesk/zendesk_api_client_php:^3.0.1 Consulte la guía de actualización. |
Conector BI de MS |
Ahora se proporciona un Zendesk Data Connector nuevo y mejorado con capacidad para obtener registros> 1000 filas y usa el modelo de cursor para una recuperación de datos más rápida. Consulte la Guía de migración para saber cómo usar el conector más reciente. |
Ir a |
>= v0.18.0 Consulte la Guía de actualización |
C# |
>= 7.0.7 admite la paginación con cursor Consulte la sección README sobre cómo usar la paginación basada en cursor |
Extremos con capacidad de CBP
Producto | Terminal |
Generación de tickets | /api/v2/activities |
Generación de tickets | /api/v2/audit_logs |
Generación de tickets | /api/v2/automations |
Generación de tickets | /api/v2/automations/active |
Generación de tickets | /api/v2/brands |
Generación de tickets | /api/v2/custom_objects/:custom_object_key/fields |
Generación de tickets | /api/v2/custom_objects/:custom_object_key/records |
Generación de tickets | /api/v2/custom_objects/:custom_object_key/records/autocomplete |
Generación de tickets | /api/v2/custom_objects/:custom_object_key/records/search |
Generación de tickets | /api/v2/custom_objects/:custom_object_key/triggers |
Generación de tickets | /api/v2/custom_objects/:custom_object_key/triggers/active |
Generación de tickets | /api/v2/deleted_tickets |
Generación de tickets | /api/v2/deleted_users |
Generación de tickets | /api/v2/deletion_schedules |
Generación de tickets | /api/v2/dynamic_content/items |
Generación de tickets | /api/v2/dynamic_content/items/:item_id/variants |
Generación de tickets | /api/v2/end_users/:end_user_id/identities |
Generación de tickets | /api/v2/group_memberships |
Generación de tickets | /api/v2/group_memberships/assignable |
Generación de tickets | /api/v2/groups |
Generación de tickets | /api/v2/groups/:group_id/memberships |
Generación de tickets | /api/v2/groups/:group_id/memberships/assignable |
Generación de tickets | /api/v2/groups/:group_id/users |
Generación de tickets | /api/v2/groups/assignable |
Generación de tickets | /api/v2/groups/available_agents |
Generación de tickets | /api/v2/incremental/ticket_metric_events |
Generación de tickets | /api/v2/job_statuses |
Generación de tickets | /api/v2/macros |
Generación de tickets | /api/v2/macros/active |
Generación de tickets | /api/v2/macros/groups |
Generación de tickets | /api/v2/organization_fields |
Generación de tickets | /api/v2/organization_memberships |
Generación de tickets | /api/v2/organization_subscriptions |
Generación de tickets | /api/v2/organizations |
Generación de tickets | /api/v2/organizations/:organization_id/organization_memberships |
Generación de tickets | /api/v2/organizations/:organization_id/requests |
Generación de tickets | /api/v2/organizations/:organization_id/subscriptions |
Generación de tickets | /api/v2/organizations/:organization_id/tickets |
Generación de tickets | /api/v2/organizations/:organization_id/users |
Generación de tickets | /api/v2/problems |
Generación de tickets | /api/v2/recipient_addresses |
Generación de tickets | /api/v2/requests |
Generación de tickets | /api/v2/requests/:request_id/comments |
Generación de tickets | /api/v2/requests/ccd |
Generación de tickets | /api/v2/requests/open |
Generación de tickets | /api/v2/requests/solved |
Generación de tickets | /api/v2/satisfaction_ratings |
Generación de tickets | /api/v2/search/export |
Generación de tickets | /api/v2/sessions |
Generación de tickets | /api/v2/skips |
Generación de tickets | /api/v2/suspended_tickets |
Generación de tickets | /api/v2/tags |
Generación de tickets | /api/v2/:target_type/:target_id/relationship_fields/:field_id/:source_type |
Generación de tickets | /api/v2/ticket_audits |
Generación de tickets | /api/v2/ticket_content_pins |
Generación de tickets | /api/v2/ticket_fields |
Generación de tickets | /api/v2/ticket_fields/:ticket_field_id/options |
Generación de tickets | /api/v2/ticket_metrics |
Generación de tickets | /api/v2/tickets |
Generación de tickets | /api/v2/tickets/:ticket_id/audits |
Generación de tickets | /api/v2/tickets/:ticket_id/comments |
Generación de tickets | /api/v2/tickets/:ticket_id/incidents |
Generación de tickets | /api/v2/tickets/:ticket_id/skips |
Generación de tickets | /api/v2/trigger_categories |
Generación de tickets | /api/v2/triggers |
Generación de tickets | /api/v2/triggers/active |
Generación de tickets | /api/v2/user_fields |
Generación de tickets | /api/v2/user_fields/:user_field_id/options |
Generación de tickets | /api/v2/users |
Generación de tickets | /api/v2/users/:user_id/group_memberships |
Generación de tickets | /api/v2/users/:user_id/groups |
Generación de tickets | /api/v2/users/:user_id/identities |
Generación de tickets | /api/v2/users/:user_id/organization_memberships |
Generación de tickets | /api/v2/users/:user_id/organization_subscriptions |
Generación de tickets | /api/v2/users/:user_id/organizations |
Generación de tickets | /api/v2/users/:user_id/requests |
Generación de tickets | /api/v2/users/:user_id/sessions |
Generación de tickets | /api/v2/users/:user_id/skips |
Generación de tickets | /api/v2/users/:user_id/tickets/assigned |
Generación de tickets | /api/v2/users/:user_id/tickets/ccd |
Generación de tickets | /api/v2/users/:user_id/tickets/requested |
Generación de tickets | /api/v2/views |
Generación de tickets | /api/v2/views/:id/execute |
Generación de tickets | /api/v2/views/:id/tickets |
Producto | Extremo |
Centro de ayuda | /hc/api/v2/incremental/articles |
Centro de ayuda | /hc/api/v2/articles/attachments/:id |
Centro de ayuda | /hc/api/v2/articles/labels |
Centro de ayuda | /hc/api/v2/articles/labels/:id |
Centro de ayuda | /hc/api/v2/articles/:article_id/translations/missing |
Centro de ayuda | /hc/api/v2/articles/:article_id/translations |
Centro de ayuda | /hc/api/v2/articles/:article_id/translations/:id |
Centro de ayuda | /hc/api/v2/categories/:category_id/translations/missing |
Centro de ayuda | /hc/api/v2/categories/:category_id/translations |
Centro de ayuda | /hc/api/v2/categories/:category_id/translations/:id |
Centro de ayuda | /hc/api/v2/user_segments/applicable |
Centro de ayuda | /hc/api/v2/user_segments/:user_segment_id/sections |
Centro de ayuda | /hc/api/v2/user_segments/:user_segment_id/topics |
Centro de ayuda | /hc/api/v2/user_segments |
Centro de ayuda | /hc/api/v2/user_segments/:id |
Centro de ayuda | /hc/api/v2/sections/:section_id/translations/missing |
Centro de ayuda | /hc/api/v2/sections/:section_id/translations |
Centro de ayuda | /hc/api/v2/sections/:section_id/translations/:id |
Centro de ayuda | /hc/api/v2(/:locale)/articles/:article_id/attachments/:scope |
Centro de ayuda | /hc/api/v2(/:locale)/articles/:article_id/attachments |
Centro de ayuda | /hc/api/v2(/:locale)/articles/:article_id/attachments/:id |
Centro de ayuda | /hc/api/v2(/:locale)/articles/:article_id/labels |
Centro de ayuda | /hc/api/v2(/:locale)/articles/:article_id/comments/:comment_id/votes |
Centro de ayuda | /hc/api/v2(/:locale)/articles/:article_id/comments |
Centro de ayuda | /hc/api/v2(/:locale)/articles/:article_id/comments/:id |
Centro de ayuda | /hc/api/v2(/:locale)/articles/:article_id/votes |
Centro de ayuda | /hc/api/v2(/:locale)/articles/:article_id/subscriptions |
Centro de ayuda | /hc/api/v2(/:locale)/articles/:article_id/subscriptions/:id |
Centro de ayuda | /hc/api/v2(/:locale)/articles |
Centro de ayuda | /hc/api/v2(/:locale)/articles/:id |
Centro de ayuda | /hc/api/v2(/:locale)/categories/:category_id/articles |
Centro de ayuda | /hc/api/v2(/:locale)/categories/:category_id/sections |
Centro de ayuda | /hc/api/v2(/:locale)/categories |
Centro de ayuda | /hc/api/v2(/:locale)/categories/:id |
Centro de ayuda | /hc/api/v2(/:locale)/sections/:section_id/articles |
Centro de ayuda | /hc/api/v2(/:locale)/sections/:section_id/subscriptions |
Centro de ayuda | /hc/api/v2(/:locale)/sections/:section_id/subscriptions/:id |
Centro de ayuda | /hc/api/v2(/:locale)/sections |
Centro de ayuda | /hc/api/v2(/:locale)/sections/:id |
Centro de ayuda | /hc/api/v2/community/posts/:post_id/comments/:comment_id/votes |
Centro de ayuda | /hc/api/v2/community/posts/:post_id/comments |
Centro de ayuda | /hc/api/v2/community/posts/:post_id/comments/:id |
Centro de ayuda | /hc/api/v2/community/posts/:post_id/subscriptions |
Centro de ayuda | /hc/api/v2/community/posts/:post_id/subscriptions/:id |
Centro de ayuda | /hc/api/v2/community/posts/:post_id/votes |
Centro de ayuda | /hc/api/v2/community/posts |
Centro de ayuda | /hc/api/v2/community/posts/:id |
Centro de ayuda | /hc/api/v2/community/topics/:topic_id/subscriptions |
Centro de ayuda | /hc/api/v2/community/topics/:topic_id/subscriptions/:id |
Centro de ayuda | /hc/api/v2/community/topics/:topic_id/posts |
Centro de ayuda | /hc/api/v2/community/topics |
Centro de ayuda | /hc/api/v2/community/topics/:id |
Centro de ayuda | /hc/api/v2/community/users/:user_id/posts |
Centro de ayuda | /hc/api/v2/community/users/:user_id/comments |
Centro de ayuda | /hc/api/v2/users/:user_id/articles |
Centro de ayuda | /hc/api/v2/users/:user_id/subscriptions |
Centro de ayuda | /hc/api/v2/users/:user_id/user_subscriptions |
Centro de ayuda | /hc/api/v2/users/:user_id/comments |
Centro de ayuda | /hc/api/v2/users/:user_id/votes |
Centro de ayuda | /hc/api/v2/users/:user_id/user_segments |
Centro de ayuda | /hc/api/v2/votes |
Centro de ayuda | /hc/api/v2/votes/:id |