| Data do anúncio | Implementação em (escalonado) |
| 22 de maio de 2023 |
20 de maio de 2024 – Regiões fora da UE – CONCLUÍDO 09 de setembro de 2024 – Região da UE – CONCLUÍDO |
Atualmente, a Zendesk oferece paginação baseada em deslocamento (OBP) e paginação baseada em cursor (CBP) para a maioria dos pontos de extremidade de API. O CBP oferece muitas vantagens em relação ao OBP e será o principal método de paginação oferecido pela Zendesk em um futuro próximo. Em um esforço para fornecer uma experiência melhor e mais rápida para nossos clientes, estamos tomando medidas para incentivar a transição para o CBP, começando com a introdução de limites mais restritos em solicitações de OBP que demandem muito deslocamento.
O anúncio responde às seguintes perguntas:
O que muda?
A partir de 20 de maio de 2024, as solicitações de OBP que superem os primeiros 10.000 registros (100 páginas) terão como resultado uma mensagem de erro: “400 Bad Request.” Para solicitar conjuntos de dados maiores que 10.000 registros, os clientes precisarão fazer a transição para o CBP.
As solicitações de OBP com menos de 10.000 registros não serão afetadas, nem as solicitações feitas usando o modelo CBP.
Por que a Zendesk está fazendo essa alteração?
Estamos fazendo essa alteração em linha com nosso anúncio anterior, que recomendava a adoção do CBP e incentivava os clientes a fazer a mudança o mais rápido possível.
A paginação com base em cursor é mais rápida e eficiente para os nossos clientes. Isso também sobrecarrega menos a infraestrutura da Zendesk e aumenta a estabilidade e a confiabilidade. Como primeira etapa, estamos limitando os recursos de paginação com base em deslocamento a um nível relativamente alto, para que a transição possa ocorrer com mínima interferência no uso atual da API.
O que devo fazer?
A Zendesk recomenda que seus clientes façam a transição para a paginação baseada em cursor antes de 20 de maio de 2024. Se você não sabe quais integrações ou aplicativos podem estar ultrapassando o limite, sugerimos uma parceria com sua equipe responsável pelo gerenciamento das integrações e aplicativos do Zendesk para investigar e determinar o que essa mudança significa para você.
A Zendesk continuará a oferecer a paginação por deslocamento, mas limitará significativamente a profundidade da página em um futuro próximo para incentivar a adoção da paginação por cursor, de alto desempenho, e melhorar os tempos de resposta para suas solicitações.
Se você tiver dúvidas ou precisar de suporte adicional, entre em contato conosco e teremos prazer em ajudá-lo. Você pode entrar em contato conosco pelo web widget.
Estamos garantindo uma transição perfeita para todos os usuários ao escalonar a implementação, com as alterações nas contas da região da UE programadas para lançamento em três meses - 09 de setembro de 2024.
Atualizações disponíveis para bibliotecas de cliente/SDKs
A Zendesk atualizou seu cliente Ruby oficial e firmou uma parceria com desenvolvedores de SDKs da comunidade para fornecer suporte a CBP. Se você estiver usando uma dessas bibliotecas, analise, teste e atualize para a versão mais atual.
| Biblioteca | Instruções úteis |
| Ruby |
>=3.0.4 oferece suporte à paginação do cursor. Consulte Uso geral na Wiki. |
| Python |
>=v2.0.34 oferece suporte à paginação do cursor. pip install zenpy --upgrade |
| NodeJS |
>=v3.0.2 oferece suporte à paginação do cursor. Consulte a tag de versão aqui. npm update node-zendesk |
| Java |
>=v0.24.1 oferece suporte à paginação do cursor. Consulte a tag de versão aqui. Uso do Maven |
| PHP |
>=3.0.01 oferece suporte à paginação do cursor. composer require zendesk/zendesk_api_client_php:^3.0.1 Consulte o guia de atualização. |
| Conector de BI do MS |
Um novo e aprimorado Conector de dados da Zendesk agora tem recursos para buscar registros > 1.000 linhas e usa o modelo de cursores para agilizar a recuperação de dados. Consulte o guia de migração para saber como usar o conector mais recente. |
| Go-lang |
>=v0.18.0 Consulte o Guia de atualização |
| C# |
>=7.0.7 oferece suporte à paginação do cursor. Consulte a seção LEIA para saber como usar a paginação baseada em cursor |
Pontos de extremidade com recurso de CBP
| Produto | Ponto de extremidade |
| Trabalho com tickets | /api/v2/activities |
| Trabalho com tickets | /api/v2/audit_logs |
| Trabalho com tickets | /api/v2/automations |
| Trabalho com tickets | /api/v2/automations/active |
| Trabalho com tickets | /api/v2/brands |
| Trabalho com tickets | /api/v2/custom_objects/:custom_object_key/fields |
| Trabalho com tickets | /api/v2/custom_objects/:custom_object_key/records |
| Trabalho com tickets | /api/v2/custom_objects/:custom_object_key/records/autocomplete |
| Trabalho com tickets | /api/v2/custom_objects/:custom_object_key/records/search |
| Trabalho com tickets | /api/v2/custom_objects/:custom_object_key/triggers |
| Trabalho com tickets | /api/v2/custom_objects/:custom_object_key/triggers/active |
| Trabalho com tickets | /api/v2/deleted_tickets |
| Trabalho com tickets | /api/v2/deleted_users |
| Trabalho com tickets | /api/v2/deletion_schedules |
| Trabalho com tickets | /api/v2/active_content/items |
| Trabalho com tickets | /api/v2/dinâmico_content/items/:item_id/variants |
| Trabalho com tickets | /api/v2/end_users/:end_user_id/identities |
| Trabalho com tickets | /api/v2/group_memberships |
| Trabalho com tickets | /api/v2/group_memberships/assignable |
| Trabalho com tickets | /api/v2/groups |
| Trabalho com tickets | /api/v2/groups/:group_id/memberships |
| Trabalho com tickets | /api/v2/groups/:group_id/memberships/assignable |
| Trabalho com tickets | /api/v2/groups/:group_id/users |
| Trabalho com tickets | /api/v2/groups/assignable |
| Trabalho com tickets | /api/v2/groups/available_agents |
| Trabalho com tickets | /api/v2/incremental/ticket_metric_events |
| Trabalho com tickets | /api/v2/job_statuses |
| Trabalho com tickets | /api/v2/macros |
| Trabalho com tickets | /api/v2/macros/active |
| Trabalho com tickets | /api/v2/macros/groups |
| Trabalho com tickets | /api/v2/organization_fields |
| Trabalho com tickets | /api/v2/organization_memberships |
| Trabalho com tickets | /api/v2/organization_subscriptions |
| Trabalho com tickets | /api/v2/organizations |
| Trabalho com tickets | /api/v2/organizations/:organization_id/organization_memberships |
| Trabalho com tickets | /api/v2/organizations/:organization_id/requests |
| Trabalho com tickets | /api/v2/organizations/:organization_id/subscriptions |
| Trabalho com tickets | /api/v2/organizations/:organization_id/tickets |
| Trabalho com tickets | /api/v2/organizations/:organization_id/users |
| Trabalho com tickets | /api/v2/problems |
| Trabalho com tickets | /api/v2/recipient_addresses |
| Trabalho com tickets | /api/v2/requests |
| Trabalho com tickets | /api/v2/requests/:request_id/comments |
| Trabalho com tickets | /api/v2/requests/ccd |
| Trabalho com tickets | /api/v2/requests/open |
| Trabalho com tickets | /api/v2/requests/solved |
| Trabalho com tickets | /api/v2/satisfaction_ratings |
| Trabalho com tickets | /api/v2/search/export |
| Trabalho com tickets | /api/v2/sessions |
| Trabalho com tickets | /api/v2/skips |
| Trabalho com tickets | /api/v2/suspended_tickets |
| Trabalho com tickets | /api/v2/tags |
| Trabalho com tickets | /api/v2/:target_type/:target_id/relationship_fields/:field_id/:source_type |
| Trabalho com tickets | /api/v2/ticket_audits |
| Trabalho com tickets | /api/v2/ticket_content_pins |
| Trabalho com tickets | /api/v2/ticket_fields |
| Trabalho com tickets | /api/v2/ticket_fields/:ticket_field_id/options |
| Trabalho com tickets | /api/v2/ticket_metrics |
| Trabalho com tickets | /api/v2/tickets |
| Trabalho com tickets | /api/v2/tickets/:ticket_id/audits |
| Trabalho com tickets | /api/v2/tickets/:ticket_id/comments |
| Trabalho com tickets | /api/v2/tickets/:ticket_id/incidents |
| Trabalho com tickets | /api/v2/tickets/:ticket_id/skips |
| Trabalho com tickets | /api/v2/trigger_categories |
| Trabalho com tickets | /api/v2/triggers |
| Trabalho com tickets | /api/v2/triggers/active |
| Trabalho com tickets | /api/v2/user_fields |
| Trabalho com tickets | /api/v2/user_fields/:user_field_id/options |
| Trabalho com tickets | /api/v2/users |
| Trabalho com tickets | /api/v2/users/:user_id/group_memberships |
| Trabalho com tickets | /api/v2/users/:user_id/groups |
| Trabalho com tickets | /api/v2/users/:user_id/identities |
| Trabalho com tickets | /api/v2/users/:user_id/organization_memberships |
| Trabalho com tickets | /api/v2/users/:user_id/organization_subscriptions |
| Trabalho com tickets | /api/v2/users/:user_id/organizations |
| Trabalho com tickets | /api/v2/users/:user_id/requests |
| Trabalho com tickets | /api/v2/users/:user_id/sessions |
| Trabalho com tickets | /api/v2/users/:user_id/skips |
| Trabalho com tickets | /api/v2/users/:user_id/tickets/assigned |
| Trabalho com tickets | /api/v2/users/:user_id/tickets/ccd |
| Trabalho com tickets | /api/v2/users/:user_id/tickets/requested |
| Trabalho com tickets | /api/v2/views |
| Trabalho com tickets | /api/v2/views/:id/execute |
| Trabalho com tickets | /api/v2/views/:id/tickets |
| Produto | Ponto de extremidade |
| Central de ajuda | /hc/api/v2/incremental/articles |
| Central de ajuda | /hc/api/v2/articles/attachments/:id |
| Central de ajuda | /hc/api/v2/articles/labels |
| Central de ajuda | /hc/api/v2/articles/labels/:id |
| Central de ajuda | /hc/api/v2/articles/:article_id/translations/missing |
| Central de ajuda | /hc/api/v2/articles/:article_id/translations |
| Central de ajuda | /hc/api/v2/articles/:article_id/translations/:id |
| Central de ajuda | /hc/api/v2/categories/:category_id/translations/missing |
| Central de ajuda | /hc/api/v2/categories/:category_id/translations |
| Central de ajuda | /hc/api/v2/categories/:category_id/translations/:id |
| Central de ajuda | /hc/api/v2/user_segments/applicable |
| Central de ajuda | /hc/api/v2/user_segments/:user_segment_id/sections |
| Central de ajuda | /hc/api/v2/user_segments/:user_segment_id/topics |
| Central de ajuda | /hc/api/v2/user_segments |
| Central de ajuda | /hc/api/v2/user_segments/:id |
| Central de ajuda | /hc/api/v2/sections/:section_id/translations/missing |
| Central de ajuda | /hc/api/v2/sections/:section_id/translations |
| Central de ajuda | /hc/api/v2/sections/:section_id/translations/:id |
| Central de ajuda | /hc/api/v2(/:locale)/articles/:article_id/attachments/:scope |
| Central de ajuda | /hc/api/v2(/:locale)/articles/:article_id/attachments |
| Central de ajuda | /hc/api/v2(/:locale)/articles/:article_id/attachments/:id |
| Central de ajuda | /hc/api/v2(/:locale)/articles/:article_id/labels |
| Central de ajuda | /hc/api/v2(/:locale)/articles/:article_id/comments/:comment_id/votes |
| Central de ajuda | /hc/api/v2(/:locale)/articles/:article_id/comments |
| Central de ajuda | /hc/api/v2(/:locale)/articles/:article_id/comments/:id |
| Central de ajuda | /hc/api/v2(/:locale)/articles/:article_id/votes |
| Central de ajuda | /hc/api/v2(/:locale)/articles/:article_id/subscriptions |
| Central de ajuda | /hc/api/v2(/:locale)/articles/:article_id/subscriptions/:id |
| Central de ajuda | /hc/api/v2(/:locale)/articles |
| Central de ajuda | /hc/api/v2(/:locale)/articles/:id |
| Central de ajuda | /hc/api/v2(/:locale)/categories/:category_id/articles |
| Central de ajuda | /hc/api/v2(/:locale)/categories/:category_id/sections |
| Central de ajuda | /hc/api/v2(/:locale)/categories |
| Central de ajuda | /hc/api/v2(/:locale)/categories/:id |
| Central de ajuda | /hc/api/v2(/:locale)/sections/:section_id/articles |
| Central de ajuda | /hc/api/v2(/:locale)/sections/:section_id/subscriptions |
| Central de ajuda | /hc/api/v2(/:locale)/sections/:section_id/subscriptions/:id |
| Central de ajuda | /hc/api/v2(/:locale)/sections |
| Central de ajuda | /hc/api/v2(/:locale)/sections/:id |
| Central de ajuda | /hc/api/v2/community/posts/:post_id/comments/:comment_id/votes |
| Central de ajuda | /hc/api/v2/community/posts/:post_id/comments |
| Central de ajuda | /hc/api/v2/community/posts/:post_id/comments/:id |
| Central de ajuda | /hc/api/v2/community/posts/:post_id/subscriptions |
| Central de ajuda | /hc/api/v2/community/posts/:post_id/subscriptions/:id |
| Central de ajuda | /hc/api/v2/community/posts/:post_id/votes |
| Central de ajuda | /hc/api/v2/community/posts |
| Central de ajuda | /hc/api/v2/community/posts/:id |
| Central de ajuda | /hc/api/v2/community/topics/:topic_id/subscriptions |
| Central de ajuda | /hc/api/v2/community/topics/:topic_id/subscriptions:id |
| Central de ajuda | /hc/api/v2/community/topics/:topic_id/posts |
| Central de ajuda | /hc/api/v2/community/topics |
| Central de ajuda | /hc/api/v2/community/topics/:id |
| Central de ajuda | /hc/api/v2/community/users/:user_id/posts |
| Central de ajuda | /hc/api/v2/community/users/:user_id/comments |
| Central de ajuda | /hc/api/v2/users/:user_id/articles |
| Central de ajuda | /hc/api/v2/users/:user_id/subscriptions |
| Central de ajuda | /hc/api/v2/users/:user_id/user_subscriptions |
| Central de ajuda | /hc/api/v2/users/:user_id/comments |
| Central de ajuda | /hc/api/v2/users/:user_id/votes |
| Central de ajuda | /hc/api/v2/users/:user_id/user_segments |
| Central de ajuda | /hc/api/v2/votes |
| Central de ajuda | /hc/api/v2/votes/:id |