Referensi AWS Partner Central API direstrukturisasi. Untuk informasi selengkapnya tentang operasi API yang didukung, lihat [Referensi AWS Partner Central API](https://docs.aws.amazon.com/partner-central/latest/APIReference/Welcome.html).

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Praktik terbaik
<a name="best-practices"></a>

## Bereaksi terhadap peristiwa
<a name="reacting-to-events"></a>

Saat menangani peristiwa dari API Pusat AWS Mitra, pastikan logika pemrosesan Anda idempoten untuk menangani kejadian duplikat. Alih-alih membuat [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)panggilan langsung untuk setiap acara, pertimbangkan untuk mengelompokkan atau secara selektif mengambil detail berdasarkan kebutuhan aplikasi Anda. [Untuk operasi tanpa gangguan, waspadalah terhadap Kuota.](quotas.md)

## Menerapkan penguncian optimis
<a name="implementing-optimistic-locking"></a>

Penguncian optimis mencegah penggantian data yang tidak diinginkan selama pembaruan bersamaan. Berikut skenario tipikal:

1. Mitra mengambil kesempatan dari sistem CRM mereka.

1. Pengguna `A` memperbarui kesempatan di AWS Partner Central.

1. Pengguna `B` memperbarui kesempatan yang sama pada saat yang sama melalui integrasi CRM.

1. Jika data berubah, sistem CRM mencoba mengunggah data tetapi mengembalikan file. `ConflictException`

1. Pengguna meninjau kesalahan dan secara manual menyelesaikan data yang bertentangan.

Untuk menghindari skenario ini, semua [UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html)permintaan harus menyertakan `LastModifiedDate` parameter, yang dapat Anda peroleh dari sebelumnya [CreateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_CreateOpportunity.html), [UpdateOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_UpdateOpportunity.html), dan [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)tindakan. Pembaruan hanya berhasil jika `LastModifiedDate` cocok dengan sistem kami. Jika tidak, Anda harus mengambil yang terbaru `LastModifiedDate` menggunakan [GetOpportunity](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_GetOpportunity.html)dan mencoba kembali pembaruan.

## Sinkronisasi data antara CRM dan AWS Pusat Partner
<a name="synchronizing-data"></a>

Sangat penting untuk menjaga sistem Anda tetap sinkron dengan data terbaru dari Partner Central. Berikut ini adalah dua strategi untuk memastikan sistem Anda mencerminkan data terbaru:

### Menggunakan acara (disarankan)
<a name="using-events"></a>

1. Muat data menggunakan [ListOpportunities](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListOpportunities.html).

1. Berlangganan acara peluang.

1. Menanggapi peluang atau perubahan baru.
   + Saat Anda menerima`Opportunity Created`,`Opportunity Updated`, atau `Engagement Invitation Accepted` acara, gunakan `GetOpportunity` untuk mengambil data terbaru.
   + Saat Anda menerima `Engagement Invitation Rejected` acara, hapus peluang yang sesuai.

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

1. Muat data menggunakan [ListOpportunities](https://docs.aws.amazon.com/partner-central/latest/APIReference/API_ListOpportunities.html).

1. Pilih frekuensi polling, pastikan tidak terlalu sering untuk menghindari kehabisan kuota [baca](quotas.md) harian Anda.

1. Identifikasi yang terbaru `LastModifiedDate` dari data yang Anda simpan, pastikan itu berasal dari AWS.

1. Gunakan stempel waktu di `AfterLastModifiedDate` filter saat menelepon. [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 akan mengembalikan peluang yang dibuat atau diperbarui setelah nilai yang ditunjukkan pada stempel waktu.

1. Ulangi semua halaman yang dikembalikan menggunakan`NextToken`, dan perbarui data sistem Anda menggunakan [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
           }
      ]
   }
   ```