Gerenciando o Uso da API do Salesforce

Visão geral

O consumo eficiente de APIs é vital para integrar o Flosum Backup & Archive com o Salesforce para o gerenciamento de dados. Este guia apresenta informações essenciais para entender e otimizar o uso de API.

O Backup & Archive utiliza as APIs REST, Bulk, Bulk com PK Chunking e Metadata, escolhendo a API mais eficiente para a tarefa. Embora o Salesforce não imponha limitações à integração do Backup & Archive, é essencial considerar os limites de API da sua organização, pois o Backup & Archive contribuirá para eles. Para mais informações sobre os limites de API do Salesforce, consulte o artigo a seguir.

• Limites e alocações de solicitações de API

Como solicitar um aumento no limite de API?

No final deste artigo há instruções para entrar em contato com o Suporte do Salesforce para solicitar um aumento temporário do limite de API da sua organização. Vá para a seção a seguir para ver essas instruções.

Gerenciando o Uso da API do Salesforce

APIs usadas com base na contagem de registros

A Flosum segue a recomendação do Salesforce de usar o Bulk API v1 com PK Chunking quando apropriado. A tabela a seguir mostra quais APIs são empregadas dependendo do número de registros no job. O Bulk API v2 não é usado pois não oferece suporte ao PK Chunking.

Contagem de registros	Tipo de API
0 a 999.999	REST
1.000.000 a 9.999.999	Bulk v1
10,000,000+	Bulk v1 com pk-chunking

O Bulk API v1 é sempre usado para objetos binários.

Cotas de API do Backup & Archive

Para evitar ultrapassar os limites de API da sua organização Salesforce, a Flosum permite que você modifique suas Cotas de API. Revise os recursos do Salesforce para obter detalhes de uso e definir sua Cotas de API para as APIs REST e Bulk. Você pode ajustar essas cotas individualmente para cada organização nas Configurações Gerais do Backup & Archive. Por exemplo, definir uma Cota de API de 80% garante que o Backup & Archive permaneça dentro desse limite. Consulte o artigo a seguir para instruções sobre como alterar esse limite. Visão Geral das Configurações Gerais

Determinando o uso de API

Os administradores do Salesforce devem inicialmente avaliar o uso de API em seu ambiente para determinar a cota de API adequada. O número total de APIs Bulk e REST usadas por período de 24 horas é limitado pelo Salesforce, dependendo do tipo de licença. É crucial considerar outras aplicações em sua organização que utilizam chamadas de API.

Para monitorar efetivamente o uso e os limites de API da sua organização, o Salesforce oferece recursos valiosos:

• Seção Uso de API da página Visão Geral do Sistema em Setup.

• Item Solicitações de API, Últimas 24 Horas na seção Detalhes da Organização da página Visão Geral do Sistema em Setup.

• Limite de Solicitações de API por Mês, um direito baseado no uso, exibe as chamadas de API agregadas da sua organização ao longo de 30 dias. Esta informação está disponível na página Informações da Empresa em Setup.

• As páginas Informações da Empresa, Uso de Armazenamento e Carga de Dados em Lote fornecem informações sobre o número de APIs utilizadas, limites diários e o número total de arquivos e anexos.

Esses recursos ajudarão você a entender os padrões de uso de API da sua organização Salesforce e facilitarão decisões informadas sobre a estratégia de Cotas de API com o Backup & Archive.

---

Criando uma solicitação de aumento de limite de API do Salesforce

Para garantir um primeiro backup completo tranquilo com o Flosum Backup & Archive, talvez seja necessário aumentar temporariamente os limites de API do Salesforce, especialmente para chamadas BULK API. Este artigo fornece um guia passo a passo para enviar uma solicitação de aumento de limite de API ao Suporte do Salesforce.

Por que isso é importante

Durante o backup completo inicial, o Backup & Archive consome um grande volume de chamadas de API (REST e BULK). Clientes já experimentaram atingir os limites de cota, o que pode interromper tanto o processo de backup quanto outras integrações. Um aumento temporário no limite evita essa interrupção.

Como enviar a solicitação de aumento de limite de API

Artigo de ajuda do Salesforce de referência: Solicitação de aumentos temporários de API

1

Acesse o Help do Salesforce

1. Visite https://help.salesforce.com

2. Clique Entrar em contato com o Suporte

3. Selecione Criar um Caso

2

Detalhes do Caso

Use as seguintes informações para preencher o formulário do caso:

• Assunto: Solicitação de aumento temporário no limite diário de solicitações de API

• Produto: Sales

• Tópico: Ativação de recurso e limites

• Tipo de Instância: Produção

• ID da Organização: [Forneça seu ID da Organização]

• Fuso Horário Preferido: [Seu Fuso Horário]

• Gravidade: 2 (Funcionalidade principal impactada; não é uma interrupção completa)

3

Descrição sugerida do caso

Copie e cole isto no campo Descrição do seu caso de suporte:

Olá Suporte Salesforce,

Gostaria de solicitar um aumento temporário do nosso limite diário de API de acordo com Artigo Salesforce 000382675.

Estamos implementando um processo de backup usando o aplicativo Flosum Backup & Archive, que utiliza as APIs REST e BULK para fazer backup de todos os registros e arquivos em nossa organização Salesforce.

Respostas às perguntas obrigatórias:

1. Você é o administrador do sistema autorizado a fazer esta solicitação?

   ✔️ Sim.

2. Você está ciente do recurso de Direito baseado no Uso para este limite?

   ✔️ Sim.

3. Qual é o ID da sua Organização?

   [Cole o ID da sua Organização de Produção]

   (Navegue até Setup > Company Information > Salesforce.com Organization ID)

4. Descreva, por favor, a emergência e o impacto nos negócios:

   Nossa solução de backup e integrações existentes dependem da disponibilidade de API. Sem o aumento dos limites, corremos o risco de falha no backup e possível interrupção das operações.

5. Quantas chamadas de API adicionais você está solicitando?

   🔺 Aumento temporário de 40–50% acima da alocação atual.

6. Como esse limite foi calculado?

   • API REST: ~1.000 chamadas por 1M de registros

   • BULK API: ~1 chamada por 2M de registros

     (Estimativas baseadas no tamanho de nossos objetos e padrões de backup)

7. Por quanto tempo você precisa desse aumento?

   📅 Máximo de 2 semanas, para acomodar o backup completo inicial.

8. Quais ações vocês tomarão para evitar esse problema no futuro?

   Continuaremos seguindo as melhores práticas do Salesforce, mas precisamos deste buffer temporário devido a operações de dados em grande escala.

4

Detalhes adicionais obrigatórios

Tipo de integração:

• ✅ Integração (não é uma migração de dados)

• Aplicação usada: Flosum Backup & Archive

• APIs usadas: REST API e BULK API

• Total de registros afetados: Todos os registros e arquivos na organização de produção

• Ferramenta ETL: N/A

• Tipo de operação: Consulta

• Carga máxima: Potencialmente o volume de dados de toda a organização

• Indexação personalizada necessária? Não

• Você entende que isto é um pedido ao programa de P&D? ✔️ Sim

• O que seria necessário para adoção do Bulk API 2.0? Adicionar suporte a pk-chunking

• Tamanho do lote: Padrão

5

Etapas finais

• Anexar colaboradores (opcional)

• Enviar o Caso

• Após a submissão, por favor compartilhe o Número do Caso com seu Arquiteto Técnico Flosum para acompanhamento.

Enviar uma solicitação de aumento de API bem estruturada é fundamental para um backup completo bem-sucedido da organização com o Flosum Backup & Archive. Siga as orientações acima para agilizar a aprovação do suporte do Salesforce e evitar interrupções inesperadas relacionadas à API.