A referência Central de Parceiros da AWS da API foi reestruturada. Para obter mais informações sobre as operações de API suportadas, consulte a [Referência Central de Parceiros da AWS da API](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Práticas recomendadas
<a name="best-practices"></a>

## Reagindo aos eventos
<a name="reacting-to-events"></a>

Ao lidar com eventos da API do AWS Partner Central, certifique-se de que sua lógica de processamento seja idempotente para lidar com eventos duplicados. Em vez de fazer [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)chamadas imediatas para cada evento, considere agrupar ou buscar seletivamente os detalhes com base nas necessidades do seu aplicativo. [Para operações ininterruptas, cuidado com as cotas.](quotas.md)

## Implementando um bloqueio otimista
<a name="implementing-optimistic-locking"></a>

O bloqueio otimista evita a substituição não intencional de dados durante atualizações simultâneas. Aqui está um cenário típico:

1. O parceiro recupera uma oportunidade de seu sistema de CRM.

1. O usuário `A` atualiza a oportunidade no AWS Partner Central.

1. O usuário `B` atualiza a mesma oportunidade ao mesmo tempo por meio da integração do CRM.

1. Se os dados mudarem, o sistema CRM tentará fazer o upload dos dados, mas retornará um`ConflictException`.

1. O usuário analisa o erro e resolve manualmente os dados conflitantes.

Para evitar esse cenário, todas as [UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)solicitações devem incluir o `LastModifiedDate` parâmetro, que você pode obter das [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)ações anteriores [CreateOpportunity[UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_CreateOpportunity.html), e. A atualização será bem-sucedida somente se `LastModifiedDate` corresponder ao nosso sistema. Caso contrário, você deve buscar a versão mais recente `LastModifiedDate` usando [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)e tentar novamente a atualização.

## Sincronizando dados entre CRM e AWS Central de Parceiros
<a name="synchronizing-data"></a>

É essencial manter seu sistema sincronizado com os dados mais recentes do Partner Central. A seguir estão duas estratégias para garantir que seu sistema reflita os dados mais recentes:

### Usando eventos (recomendado)
<a name="using-events"></a>

1. Carregue dados usando [ListOpportunities](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListOpportunities.html).

1. Inscreva-se em eventos de oportunidades.

1. Responda a novas oportunidades ou mudanças.
   + Quando você recebe `Opportunity Created``Opportunity Updated`, ou `Engagement Invitation Accepted` eventos, use `GetOpportunity` para buscar os dados mais recentes.
   + Ao receber `Engagement Invitation Rejected` eventos, remova as oportunidades correspondentes.

### Usando a ListOpportunities enquete
<a name="using-listopportunities-polling"></a>

1. Carregue dados usando [ListOpportunities](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListOpportunities.html).

1. [Escolha uma frequência de pesquisa, garantindo que ela não seja muito frequente para evitar esgotar sua cota de leitura diária.](quotas.md)

1. Identifique os dados mais recentes `LastModifiedDate` de seus dados armazenados, garantindo que sejam originários de AWS.

1. Use o timestamp no `AfterLastModifiedDate` filtro ao ligar. [ListOpportunities](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListOpportunities.html)

   ```
   {
      "FilterList": [
          {
              "Name": "AfterLastModifiedDate",
              "ValueList": [ "2023-05-01T20:37:46Z" ] // Replace with actual timestamp of your last synced data
           }
      ]
   }
   ```

1. AWS retornará oportunidades criadas ou atualizadas após o valor indicado no timestamp.

1. Repita todas as páginas retornadas usando `NextToken` e atualize os dados do seu sistema usando [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html).

   ```
   {
      "NextToken": "AAMA-EFRSN...PZa942D",
      "FilterList": [
          {
              "Name": "AfterLastModifiedDate",
              "ValueList": [ "2023-05-01T20:37:46Z" ] // Replace with actual timestamp of your last synced data
           }
      ]
   }
   ```