L' Centrale Partner AWS API Reference è stato ristrutturato. Per ulteriori informazioni sulle operazioni API supportate, consulta l'[Centrale Partner AWS API Reference.](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html)

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Best practice
<a name="best-practices"></a>

## Reagire agli eventi
<a name="reacting-to-events"></a>

Quando gestisci gli eventi dall'API AWS Partner Central, assicurati che la logica di elaborazione sia idempotente per gestire eventi duplicati. Invece di effettuare [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)chiamate immediate per ogni evento, prendete in considerazione la possibilità di raggruppare i dettagli in batch o di recuperare selettivamente i dettagli in base alle esigenze dell'applicazione. [Per operazioni senza interruzioni, fai attenzione a Quotas.](quotas.md)

## Implementazione del blocco ottimistico
<a name="implementing-optimistic-locking"></a>

Il blocco ottimistico impedisce la sovrascrittura involontaria dei dati durante gli aggiornamenti simultanei. Ecco uno scenario tipico:

1. Il partner recupera un'opportunità dal proprio sistema CRM.

1. L'utente `A` aggiorna l'opportunità su AWS Partner Central.

1. L'utente `B` aggiorna la stessa opportunità contemporaneamente tramite l'integrazione CRM.

1. Se i dati cambiano, il sistema CRM tenta di caricare i dati ma restituisce un. `ConflictException`

1. L'utente esamina l'errore e risolve manualmente i dati in conflitto.

Per evitare questo scenario, tutte le [UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)richieste devono includere il `LastModifiedDate` parametro, che è possibile ottenere dalla versione precedente [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 le azioni. [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html) L'aggiornamento ha esito positivo solo se `LastModifiedDate` corrisponde al nostro sistema. In caso contrario, devi recuperare la versione più recente [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)e ritentare `LastModifiedDate` l'aggiornamento.

## Sincronizzazione dei dati tra CRM e AWS Centrale Partner
<a name="synchronizing-data"></a>

È essenziale mantenere il sistema sincronizzato con i dati più recenti di Partner Central. Di seguito sono riportate due strategie per garantire che il sistema rifletta i dati più recenti:

### Utilizzo degli eventi (consigliato)
<a name="using-events"></a>

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

1. Iscriviti agli eventi di opportunità.

1. Rispondi a nuove opportunità o cambiamenti.
   + Quando ricevi o ricevi `Engagement Invitation Accepted` eventi `Opportunity Created``Opportunity Updated`, usalo `GetOpportunity` per recuperare i dati più recenti.
   + Quando ricevi `Engagement Invitation Rejected` eventi, rimuovi le opportunità corrispondenti.

### Utilizzo dei ListOpportunities sondaggi
<a name="using-listopportunities-polling"></a>

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

1. Scegliete una frequenza di sondaggio, assicurandovi che non sia troppo frequente per evitare di esaurire la quota di [lettura](quotas.md) giornaliera.

1. Identifica le ultime novità `LastModifiedDate` tra i dati archiviati, assicurandoti che provengano da.AWS

1. Usa il timestamp nel `AfterLastModifiedDate` filtro quando chiami. [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 restituirà le opportunità create o aggiornate dopo il valore indicato nel timestamp.

1. Esegui un'iterazione su tutte le pagine restituite utilizzando `NextToken` e aggiorna i dati del sistema utilizzando. [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
           }
      ]
   }
   ```