--- title: "Possíveis Alterações Incompatíveis na API Cato e EoL" slug: "cato-api-potentially-breaking-changes-and-eol" updated: 2026-11-05T00:09:18Z published: 2026-11-05T00:09:18Z canonical: "knowledge.catonetworks.com/cato-api-potentially-breaking-changes-and-eol" --- > ## Documentation Index > Fetch the complete documentation index at: https://knowledge.catonetworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Possíveis Alterações Incompatíveis na API Cato e EoL Este artigo é uma plataforma para notificações sobre alterações potencialmente incompatíveis e anúncios de fim de vida (EoL) para o esquema Cato GraphQL API e contém informações que podem exigir que você atualize o cliente da API. Os termos da API usados neste artigo são explicados em [O que é a API Cato](/v1/docs/what-is-the-cato-api). Para qualquer cliente que use a API Cato, recomendamos que você clique em **Seguir** para receber automaticamente notificações por Email sobre atualizações deste artigo sobre alterações na API. Você também pode ver mais informações sobre novas e atualizadas APIs no [Registro de Mudanças da API Cato](/v1/docs/cato-api-changelog). Para mais informações sobre as APIs, consulte a [Referência da API GraphQL da Cato Networks](https://api.catonetworks.com/documentation/). ## Mudanças Potencialmente Quebráveis ### 2026-12-1 - Mudanças na API e Limitação de Taxas Iniciando em 1 de dezembro de 2026, a Cato está gradualmente introduzindo um novo gateway API que inclui alterações na limitação de taxas da API. O novo modelo inclui: - Limitação de taxa baseada em pontos: cada operação consome pontos com base no seu custo, em vez de contar cada chamada igualmente. - Um orçamento de conta compartilhado: as operações retiram pontos do mesmo orçamento de conta, que é reabastecido ao longo do tempo. - Orçamentos de operações adicionais: algumas operações têm seu próprio orçamento além do orçamento de conta compartilhado. - Orientação para repetição: as respostas da API indicam quanto tempo esperar antes de tentar novamente ou quando simplificar ou dividir uma solicitação que excede a capacidade. **IMPORTANTE:** Esta não é uma alteração crítica. Não há degradação para suas integrações existentes, e nenhuma ação é exigida. Para mais informações, veja [FAQ: Mudanças no Gateway API e Limitação de Taxas](/v1/docs/faq-upcoming-api-gateway-and-rate-limiting-changes) ### 2026-08-30 - Validação de esquema de tipo mais estrito A partir de 30 de agosto de 2026, estamos implementando uma validação de tipo mais estrita em toda a API para alinhar com o esquema documentado. Chamadas de API que passam um valor em um formato que não corresponde ao tipo documentado do campo podem ser afetadas, dependendo do ponto de extremidade. - **O que está mudando:** Os parâmetros devem corresponder exatamente ao tipo definido no esquema. Por exemplo, campos do tipo `Int` aceitarão apenas valores inteiros — entradas de string como `"5"` não serão mais aceitas. Isso não se limita a campos Int — qualquer parâmetro passado em um formato que não corresponda ao tipo documentado pode ser afetado. - **O que você deve fazer antes de 30 de agosto de 2026:** - Revise suas chamadas de API para valores passados em um formato que não corresponda ao tipo de esquema documentado (por exemplo, valores numéricos passados como strings). - Atualize qualquer chamada desalinhada. ### 2026-06-21 - Campos do ID da API: Alteração do Tipo de Long/Inteiro para String Atualmente, o gateway da API da Cato pode retornar campos de ID como String ou Long (inteiro). Como parte de uma próxima atualização de infraestrutura, todos os campos de ID serão consistentemente retornados como Strings. - **O que está mudando:** As respostas da API que anteriormente retornavam campos de ID como valores numéricos Long (por exemplo, `1000000002`) agora sempre os retornam como Strings (por exemplo, `"1000000002"`). - **Quem é afetado:** Clientes de API que manipulam campos de ID estritamente como tipos Long/inteiro podem apresentar falhas quando essa mudança for implementada. - **O que você deve fazer antes de 21 de junho de 2026:** Atualize o código do seu cliente de API para aceitar tanto Longs quanto Strings para os campos de ID. Isso garantirá uma transição suave e evitará interrupções quando a alteração entrar em vigor. ### 2025-08-10 - Alteração no campo de Email nas APIs addAdmin e updateAdmin Em 10 de agosto de 2025, o campo `email` nas APIs addAdmin e updateAdmin tornou-se opcional (pode ser nulo). Essa alteração suporta infraestrutura futura para controle de acesso granular à API que inclui scripts e automações usando principais de serviço. - Administradores humanos CMA atuais e futuros devem sempre incluir um valor `email` - Consultas que retornam apenas administradores humanos não são afetadas. - Alguns clientes podem precisar lidar com valores nulos em payloads de resposta, como addAdminPayload Isso não é tipicamente uma alteração incompatível, mas pode impactar clientes que assumem que o `email` sempre está presente. Revise sua integração para evitar problemas. ### 2025-04-27 - A API de consulta eventsFeed suporta o recebimento dos eventos mais recentes A API eventsFeed usa um marcador para permitir puxar iterativamente o feed de eventos. O campo Marker mostra um identificador que indica o início de uma nova iteração para buscar eventos. A API lê eventos da fila com base no campo Marker único, e fornece a próxima localização do marcador na resposta. Se não houver novos eventos na fila, então o campo Marker fica vazio Um modelo alternativo de consumo de eventos é usar a integração direta sem código, veja [Integração de Eventos Cato com AWS S3](/v1/docs/integrating-cato-events-with-aws-s3) e [Integração de Eventos Cato com Conta de Armazenamento Azure](%%LINK:13539822366493%%). **O que mudamos?** - Anteriormente, quando o marcador não era especificado, a API retornava o marcador mais antigo disponível. Isso exigia consumir toda a fila de eventos antes de alcançar os eventos mais recentes. - A partir de 27 de abril de 2025, se nenhum marcador for especificado, a API retorna o marcador mais recente. Isso permite que a API busque diretamente os eventos mais recentes. **É uma alteração incompatível?** - Não há impacto para a maioria dos casos de uso da API eventsFeed. Não há mudança quando o campo Marker é usado para uma consulta, e a lógica de consumo de eventos permanece a mesma. - Se você tiver uma lógica dedicada para consumir a fila até alcançar os eventos recentes, essa lógica não é mais necessária. - Agora, se nenhum marcador de entrada for especificado, a API fornece o marcador mais recente. Chamar a API com este marcador busca os eventos mais recentes - A resposta da API contém um marcador que aponta para a localização mais recente (topo da fila) - Os scripts correspondentes e os processos automatizados devem ser atualizados ### 2025-02-09 - Alteração para a API XDR, limit=0 não é mais suportado Alteramos a funcionalidade do campo `limit` para que `limit=0` não seja mais suportado, já que isso não é considerado uma boa prática. Para garantir a continuidade do funcionamento suave, você precisa atualizar quaisquer scripts ou consultas que dependam desse parâmetro. Em vez disso, você pode definir um limite entre 1-2000, que é totalmente suportado pela API. Se você precisar recuperar todas as histórias, recomendamos usar uma abordagem de paginação. ## Próximos Anúncios de Fim de Vida ## Anúncios de Fim de Vida Anteriores ### 2026-03-18 - Fim de Vida para Campo SecondarySocketSerial O campo de evento `secondary_socket_serial` na API `EventFieldName` está atualmente marcado como Obsoleto e atingiu o fim de vida (EoL) em 18 de março de 2026. Campo alternativo recomendado: `socket_serial` ### 2025-06-30 - Fim de Vida para os Tipos LastMileBwInput, InterfaceInfo e SocketInterfaceBandwidthInput Os seguintes [campos e tipos](https://api.catonetworks.com/documentation/#definition-LastMileBwInput) na API `LastMileBWInput` estão atualmente marcados como Obsoletos e atingiram o fim de vida (EoL) em 30 de junho de 2025. Por favor, use os campos e tipos recomendados em vez disso. | Tipo Obsoleto | Tipo Recomendado | | --- | --- | | descendente | downstreamMbpsPrecision | | ascendente | upstreamMbpsPrecision | Os seguintes [campos e tipos](https://api.catonetworks.com/documentation/#definition-InterfaceInfo) na API `InterfaceInfo` estão atualmente marcados como Obsoletos e atingiram o fim de vida (EoL) em 30 de junho de 2025. Por favor, use os campos e tipos recomendados. | Tipo Obsoleto | Tipo Recomendado | | --- | --- | | downstreamBandwidth | downstreamBandwidthMbpsPrecision | | upstreamBandwidth | upstreamBandwidthMbpsPrecision | Os seguintes [campos e tipos](https://api.catonetworks.com/documentation/#definition-SocketInterfaceWanInput) na API `SocketInterfaceBandwidthInput` estão atualmente marcados como Obsoletos e atingiram o fim de vida (EoL) em 30 de junho de 2025. Por favor, use os campos e tipos recomendados em vez disso. | Tipo Obsoleto | Tipo Recomendado | | --- | --- | | downstreamBandwidth | downstreamBandwidthMbpsPrecision | | upstreamBandwidth | upstreamBandwidthMbpsPrecision | ### 2025-06-08 - Fim de Vida para Campo EventFieldName em FieldNameInput - A API de consulta `auditFeed aceita uma lista de filtros usando o tipo `AuditFieldFilterInput``. Cada filtro inclui um `fieldName` definido pelo tipo `FieldNameInput`, que atualmente inclui dois campos de entrada: `AuditFieldName` e `EventFieldName`. - No entanto, apenas `AuditFieldName` é um campo de entrada válido e suportado. Para melhorar a clareza do esquema e evitar confusões, o campo `EventFieldName` foi removido do esquema em 8 de junho de 2025. - Atualize todos os scripts e consultas que usam filtros `auditFeed` para usar apenas o campo de entrada `AuditFieldName`. ### 2025-05-01 - Fim de Vida para os Tipos EventFieldName Os seguintes [campos e tipos](https://api.catonetworks.com/documentation/#definition-EventFieldName) na API `EventFieldName` estão atualmente marcados como Obsoletos e atingiram o fim de vida (EoL) em 1 de maio de 2025. Por favor, use os campos e tipos recomendados em vez disso. | Tipo Obsoleto | Tipo Recomendado | | --- | --- | | aplicação | application_id/application_name | | categorias_personalizadas | custom_category_id/custom_category_name | | categoria_personalizada | custom_category_id/custom_category_name | | site_de_destino | dest_site_id/dest_site_name | | device_posture_profiles | device_posture_profile | | internalId | event_id | | rule | rule_name | | src_site | src_site_id/src_site_name | ### 2025-04-15 - Fim de Vida para bgp_peer_description O campo bgp_peer_description na API `EventFieldName` foi marcado como Obsoleto e está no final de sua vida útil (EoL) a partir de 15 de abril de 2025. ### 2025-03-01 - Fim de Vida para Tipos EventFieldName Os [campos e tipos](https://api.catonetworks.com/documentation/#definition-EventFieldName) seguintes na API `EventFieldName` foram marcados como Obsoletos e estão no fim de vida (EoL) a partir de 1 de março de 2025. Por favor, use os campos e tipos recomendados. | Tipo Obsoleto | Tipo Recomendado | | --- | --- | | parent_pid | src_process_parent_pid | | pid | src_pid | | process_path | src_process_path | ### 2025-02-23 - Fim de Vida para o Campo de Valor StoryDrillDownFilter O [campo](https://api.catonetworks.com/documentation/#definition-StoryDrillDownFilter) seguinte na API Beta `StoryDrillDownFilter` foi marcado como Obsoleto e está no fim de vida (EoL) a partir de 23 de fevereiro de 2025. Por favor, use os campos e tipos recomendados em vez disso. | Tipo Obsoleto | Tipo Recomendado | | --- | --- | | Valor | Insira a versão do SO | ### 2025-02-11 - Fim de Vida para Algumas SubTipos de Dados de Evento Cato Após o [anúncio](/v1/docs/upcoming-eol-for-some-subtypes-of-cato-event-data) de EoL para alguns valores de SubType usados nas APIs de consumo de eventos relacionados aos Clientes Cato, a implementação está pausada para contas que usam a localização CMA Irlanda (cc.catonetworks.com) para os seguintes campos: | Tipo Obsoleto | Tipo Recomendado | | --- | --- | | Reconectado | Conectado ou Desconectado | | Alteração de PoP | Conectado ou Desconectado (O nome do PoP é retornado no campo lastPopName.) | - Para mais informações, consulte [CMA - Diretrizes Técnicas](/v1/docs/cma-technical-guidelines) ### 2025-01-02 - Fim de Vida para SubTipos de Evento Os seguintes campos e tipos relacionados ao Cliente Cato foram marcados como Obsoletos e estão em fim de vida (EoL) a partir de 2 de janeiro de 2025. Por favor, use os campos e tipos recomendados. | Tipo Obsoleto | Tipo Recomendado | Nota | | --- | --- | --- | | VPN Nunca Desligado-Bypass | Sempre Ativo Bypass | O valor SubTipo VPN Nunca Desligado-Bypass está sendo substituído pelo valor Sempre Ativo Bypass | | Reconectado | Conectado ou Desconectado | Para aumentar a granularidade, o valor SubTipo Reconectado está sendo dividido em 2 novos valores, Conectado e Desconectado | | Alteração de PoP | Conectado ou Desconectado (O nome do PoP é retornado no campo lastPopName) | Para aumentar a granularidade, o valor SubTipo Alteração de PoP está sendo dividido em 2 novos valores, Conectado e Desconectado | - Para mais informações, veja este artigo: [Próximo EoL para Alguns SubTypes dos Dados de Eventos Cato](/v1/docs/upcoming-eol-for-some-subtypes-of-cato-event-data)