**Pemberitahuan akhir dukungan:** Pada 30 Oktober 2026, AWS akan mengakhiri dukungan untuk Amazon Pinpoint. Setelah 30 Oktober 2026, Anda tidak akan lagi dapat mengakses konsol Amazon Pinpoint atau sumber daya Amazon Pinpoint (titik akhir, segmen, kampanye, perjalanan, dan analitik). Untuk informasi selengkapnya, lihat [Amazon Pinpoint akhir dukungan.](https://docs.aws.amazon.com/console/pinpoint/migration-guide) **Catatan:** APIs terkait dengan SMS, suara, push seluler, OTP, dan validasi nomor telepon tidak terpengaruh oleh perubahan ini dan didukung oleh AWS End User Messaging.
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Siapkan Postman untuk digunakan dengan Amazon Pinpoint
Sekarang setelah Anda membuat pengguna yang dapat mengakses Amazon Pinpoint API, Anda dapat mengatur Postman. Di bagian ini, Anda membuat satu atau lebih lingkungan di Postman. Selanjutnya, Anda mengimpor koleksi yang berisi templat permintaan untuk setiap operasi di Amazon Pinpoint API.
## Buat ruang kerja Postman
Di Postman, *ruang kerja* adalah wadah organisasi untuk proyek dan lingkungan. Di bagian ini, Anda membuat setidaknya satu ruang kerja untuk digunakan dengan Amazon Pinpoint.
**Buat ruang kerja**
Di Postman, pilih tindakan lainnya pilih **File**, lalu pilih **Baru**.
1. Pada jendela **Create New**, pilih **Workspace**.
1. Masukkan nama, ringkasan, dan atur visibilitas ke pribadi. Kemudian pilih **Create Workspace**.
## Buat lingkungan Postman
Dalam Postman, *lingkungan* adalah seperangkat variabel yang disimpan sebagai pasangan kunci-nilai. Anda dapat menggunakan lingkungan untuk mengubah konfigurasi permintaan yang Anda buat melalui Postman, tanpa harus mengubah permintaan API itu sendiri.
Di bagian ini, Anda membuat setidaknya satu lingkungan untuk digunakan dengan Amazon Pinpoint. Setiap lingkungan yang Anda buat berisi serangkaian variabel yang spesifik untuk akun Anda dalam satu Wilayah AWS. Jika Anda menggunakan prosedur di bagian ini untuk membuat lebih dari satu lingkungan, Anda dapat mengubah antar Wilayah dengan memilih lingkungan yang berbeda dari menu **Lingkungan** di Tukang Pos.
**Untuk membuat lingkungan**
1. Di Postman, pilih menu tindakan lainnya, pilih **File**, lalu pilih **Baru**.
1. Pada jendela **Create New**, pilih **Environment**.
1. Pada jendela **KELOLA LINGKUNGAN**, untuk **Nama Lingkungan**, masukkan**Amazon Pinpoint - *Region Name***. Ganti *Region Name* dengan salah satu nilai berikut:
+ AS Timur (Virginia Utara)
+ US West (Oregon)
+ Asia Pasifik (Mumbai)
+ Asia Pasifik (Sydney)
+ Europe (Frankfurt)
+ Eropa (Irlandia)
**catatan**
Minimal, Anda hanya perlu membuat satu lingkungan untuk satu Wilayah AWS, dan itu Wilayah AWS harus berisi satu proyek. Jika Anda belum membuat proyek di salah satu yang terdaftar sebelumnya Wilayah AWS, lihat [Membuat proyek Amazon Pinpoint dengan dukungan email di Panduan](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) Pengguna *Amazon Pinpoint*.
1. Buat enam variabel baru:`endpoint`,`region`,`serviceName`,`accountId`,`accessKey`, dan`secretAccessKey`. Gunakan tabel berikut untuk menentukan nilai mana yang akan dimasukkan dalam kolom **Nilai Awal** dan **Nilai Saat Ini** untuk setiap variabel.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/userguide/tutorials-using-postman-configuration.html)
Setelah Anda membuat variabel-variabel ini, jendela **MANAGE** ENVIRONMENTS menyerupai contoh yang ditunjukkan pada gambar berikut.
![\[\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/userguide/images/Postman_Tutorial_2.1_4.png)
Setelah selesai, pilih **Simpan**.
**penting**
Kunci akses yang ditunjukkan pada gambar sebelumnya adalah fiktif. Jangan bagikan kunci akses IAM Anda dengan orang lain.
Tukang pos menyertakan fitur yang memungkinkan Anda untuk berbagi dan mengekspor lingkungan. Jika Anda menggunakan fitur-fitur ini, pastikan untuk tidak membagikan ID kunci akses dan kunci akses rahasia Anda dengan siapa pun yang seharusnya tidak memiliki akses ke kredensyal ini.
Untuk informasi selengkapnya, lihat [Praktik terbaik IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) dalam *Panduan Pengguna IAM*.
1. (Opsional) Ulangi langkah 1-4 untuk setiap lingkungan tambahan yang ingin Anda buat.
**Tip**
Di Postman, Anda dapat membuat lingkungan sebanyak yang Anda butuhkan. Anda dapat menggunakan lingkungan dengan cara berikut:
Buat lingkungan terpisah untuk setiap Wilayah tempat Anda harus menguji Amazon Pinpoint API.
Buat lingkungan yang terkait dengan yang berbeda Akun AWS.
Buat lingkungan yang menggunakan kredensional yang terkait dengan pengguna lain.
1. Setelah Anda selesai membuat lingkungan, lanjutkan ke bagian berikutnya.
## Buat koleksi Amazon Pinpoint di Postman
Di Postman, *koleksi* adalah sekelompok permintaan API. Permintaan dalam koleksi biasanya disatukan oleh tujuan bersama. Di bagian ini, Anda membuat koleksi baru yang berisi templat permintaan untuk setiap operasi di Amazon Pinpoint API.
**Untuk membuat koleksi Amazon Pinpoint**
1. Di Postman, pilih menu tindakan lainnya, pilih **File**, lalu pilih **Impor**.
1. Pada jendela **Impor**, pilih **Impor Dari Tautan**, lalu masukkan URL berikut: [https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon](https://raw.githubusercontent.com/awsdocs/amazon-pinpoint-developer-guide/master/Amazon%20Pinpoint.postman_collection.json) %20pinpoint.postman\$1collection.json.
Pilih **Impor**. Postman mengimpor koleksi Amazon Pinpoint, yang berisi 120 contoh permintaan.
## Uji konfigurasi Tukang Pos Anda
Setelah Anda mengimpor koleksi Amazon Pinpoint, kami sarankan Anda melakukan tes cepat untuk memverifikasi bahwa semua komponen telah dikonfigurasi dengan benar. Anda dapat menguji konfigurasi Anda dengan mengirimkan permintaan. `GetApps` Permintaan ini mengembalikan daftar semua proyek yang ada di akun Amazon Pinpoint Anda saat ini. Wilayah AWS Permintaan ini tidak memerlukan konfigurasi tambahan, jadi ini adalah cara yang baik untuk menguji konfigurasi Anda.
**Untuk menguji konfigurasi koleksi Amazon Pinpoint**
1. **Di panel navigasi kiri, pilih **Koleksi**, perluas koleksi **Amazon** Pinpoint, lalu perluas folder Apps.**
1. Dalam daftar permintaan, pilih **GetApps**.
1. Gunakan pemilih **Lingkungan** untuk memilih lingkungan yang Anda buat di lingkungan [Create Postman](#tutorials-using-postman-configuration-create-environments).
1. Pilih **Kirim**. Jika permintaan berhasil dikirim, panel respons menampilkan status. `200 OK` Anda melihat respons yang menyerupai contoh pada gambar berikut.
![\[\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/userguide/images/Postman_Tutorial_2.3_3.png)
**catatan**
Jika Anda tidak memiliki proyek apa pun yang dibuat di Wilayah AWS Amazon Pinpoint kembali. `{ "Item": [] }`
Tanggapan ini menampilkan daftar semua proyek Amazon Pinpoint yang ada di akun Anda di Wilayah yang Anda pilih pada langkah 3.
### Pemecahan masalah
Ketika Anda mengirimkan permintaan Anda, Anda mungkin melihat kesalahan. Lihat daftar berikut untuk beberapa kesalahan umum yang mungkin Anda temui, dan untuk langkah-langkah yang dapat Anda ambil untuk mengatasinya.
| Pesan kesalahan | Masalah | Resolusi |
| --- | --- | --- |
| Tidak bisa mendapatkan respons apa pun Ada kesalahan saat menghubungkan ke https://%7B%7Bendpoint%7D%7D/v1/apps. | Tidak ada nilai saat ini untuk `{{endpoint}}` variabel, yang diatur ketika Anda memilih lingkungan. | Gunakan pemilih lingkungan untuk memilih lingkungan. |
| Token keamanan yang disertakan dalam permintaan tidak valid. | Tukang pos tidak dapat menemukan nilai saat ini dari ID kunci akses atau kunci akses rahasia Anda. | Pilih ikon roda gigi di dekat pemilih lingkungan, lalu pilih lingkungan saat ini. Verifikasi bahwa `secretAccessKey` nilai `accessKey` dan muncul di kolom **NILAI AWAL dan NILAI** **SAAT INI**, dan Anda memasukkan kredensialnya dengan benar. |
| “Message”: “User: arn:aws:iam: :123456789012:user/ tidak berwenang untuk melakukan: mobiletargeting: on resource: arn:aws:mobiletargeting:us-west- 2:123456789012PinpointPostmanUser: \$1” GetApps | Kebijakan IAM yang terkait dengan pengguna Anda tidak menyertakan izin yang sesuai. | [Verifikasi bahwa pengguna Anda memiliki izin yang dijelaskan dalam [kebijakan Buat IAM](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy), dan Anda memberikan kredensyal yang benar saat membuat lingkungan di ruang kerja Create Postman.](#tutorials-using-postman-configuration-create-environments) |
**Berikutnya**: [Kirim permintaan tambahan](tutorials-using-postman-sample-requests.md)