> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/backup-and-archive/backup-and-archive-docs-pt-br/informacoes-gerais/gerenciamento/gerenciando-o-uso-da-api-do-salesforce.md).
# 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](https://developer.salesforce.com/docs/atlas.en-us.salesforce_app_limits_cheatsheet.meta/salesforce_app_limits_cheatsheet/salesforce_app_limits_platform_api.htm)
{% hint style="info" %}
#### 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.
[#creating-a-salesforce-api-limit-increase-request](#creating-a-salesforce-api-limit-increase-request "mention")
{% endhint %}
### 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 |
{% hint style="info" %}
O Bulk API v1 é sempre usado para objetos binários.
{% endhint %}
### 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. [Alterando as configurações gerais](/backup-and-archive/backup-and-archive-docs-pt-br/configuracoes/configuracoes-da-organizacao/backup-and-archive-settings-general-settings.md)
### 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.
{% hint style="info" %}
#### 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.
{% endhint %}
### Como enviar a solicitação de aumento de limite de API
{% hint style="info" %}
Artigo de ajuda do Salesforce de referência: [Solicitação de aumentos temporários de API](https://help.salesforce.com/s/articleView?id=000382675\&type=1)
{% endhint %}
{% stepper %}
{% step %}
#### Acesse o Help do Salesforce
1. Visite [https://help.salesforce.com](https://help.salesforce.com/)
2. Clique **Entrar em contato com o Suporte**
3. Selecione **Criar um Caso**
{% endstep %}
{% step %}
#### 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)
{% endstep %}
{% step %}
#### 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](https://help.salesforce.com/s/articleView?id=000382675\&type=1).
>
> 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*](https://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.
> {% endstep %}
{% step %}
#### 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
{% endstep %}
{% step %}
#### 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.
{% endstep %}
{% endstepper %}
{% hint style="success" %}
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.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.flosum.com/backup-and-archive/backup-and-archive-docs-pt-br/informacoes-gerais/gerenciamento/gerenciando-o-uso-da-api-do-salesforce.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.