La référence AWS Partner Central d'API a été restructurée. Pour plus d'informations sur les opérations d'API prises en charge, consultez la [référence des AWS Partner Central API](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Bonnes pratiques
<a name="best-practices"></a>

## Réagir aux événements
<a name="reacting-to-events"></a>

Lorsque vous gérez des événements depuis l'API AWS Partner Central, assurez-vous que votre logique de traitement est idempotente pour gérer les événements dupliqués. Au lieu de passer des [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)appels immédiats pour chaque événement, pensez à regrouper ou à récupérer les détails de manière sélective en fonction des besoins de votre application. Pour des opérations ininterrompues, méfiez-vous des [quotas](quotas.md).

## Mettre en œuvre un verrouillage optimiste
<a name="implementing-optimistic-locking"></a>

Le verrouillage optimisé empêche le remplacement involontaire des données lors de mises à jour simultanées. Voici un scénario typique :

1. Le partenaire récupère une opportunité dans son système CRM.

1. L'utilisateur `A` met à jour l'opportunité sur AWS Partner Central.

1. L'utilisateur `B` met à jour la même opportunité en même temps grâce à l'intégration CRM.

1. Si les données changent, le système CRM tente de les télécharger mais renvoie un`ConflictException`.

1. L'utilisateur examine l'erreur et résout manuellement les données contradictoires.

Pour éviter ce scénario, toutes les [UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)demandes doivent inclure le `LastModifiedDate` paramètre, que vous pouvez obtenir à partir des informations précédentes [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), et [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)les actions. La mise à jour ne réussit que si elle `LastModifiedDate` correspond à notre système. Si ce n'est pas le cas, vous devez récupérer la dernière version [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)et `LastModifiedDate` réessayer la mise à jour.

## Synchronisation des données entre CRM et AWS Partner Central
<a name="synchronizing-data"></a>

Il est essentiel de synchroniser votre système avec les dernières données de Partner Central. Voici deux stratégies pour garantir que votre système reflète les données les plus récentes :

### Utilisation d'événements (recommandé)
<a name="using-events"></a>

1. Chargez les données à l'aide de [ListOpportunities](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListOpportunities.html).

1. Abonnez-vous à des événements d'opportunité.

1. Répondez aux nouvelles opportunités ou aux changements.
   + Lorsque vous recevez `Opportunity Created` ou que vous recevez `Engagement Invitation Accepted` des événements, utilisez `GetOpportunity` pour récupérer les dernières données. `Opportunity Updated`
   + Lorsque vous recevez `Engagement Invitation Rejected` des événements, supprimez les opportunités correspondantes.

### Utilisation ListOpportunities du sondage
<a name="using-listopportunities-polling"></a>

1. Chargez les données à l'aide de [ListOpportunities](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListOpportunities.html).

1. Choisissez une fréquence d'interrogation, en veillant à ce qu'elle ne soit pas trop fréquente pour ne pas épuiser votre [quota de lecture](quotas.md) quotidien.

1. Identifiez les données les plus récentes `LastModifiedDate` de vos données stockées, en vous assurant qu'elles proviennent de AWS.

1. Utilisez l'horodatage dans le `AfterLastModifiedDate` filtre lorsque vous appelez. [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 renverra les opportunités créées ou mises à jour après la valeur indiquée sur l'horodatage.

1. Effectuez une itération sur toutes les pages renvoyées en utilisant `NextToken` et mettez à jour les données de votre système à l'aide [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)de.

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