**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.
# Tutorial: Menggunakan Postman dengan Amazon Pinpoint API
Tukang pos adalah alat populer untuk pengujian APIs di lingkungan easy-to-use grafis. Anda dapat menggunakan Postman untuk mengirim permintaan API ke REST API apa pun, dan untuk menerima tanggapan atas permintaan Anda. Menggunakan Postman adalah cara mudah untuk menguji dan memecahkan masalah panggilan yang Anda lakukan ke Amazon Pinpoint API. Tutorial ini mencakup prosedur untuk mengatur dan menggunakan Postman dengan Amazon Pinpoint.
**catatan**
Tukang pos dikembangkan oleh perusahaan pihak ketiga. Ini tidak dikembangkan atau didukung oleh Amazon Web Services (AWS). Untuk mempelajari lebih lanjut tentang menggunakan Tukang Pos, atau untuk bantuan terkait masalah yang terkait dengan Tukang Pos, lihat [Pusat Dukungan](https://support.postman.com/hc/en-us) di situs web Postman.
## Tentang tutorial ini
Bagian ini berisi ikhtisar tutorial ini.
**Audiens yang Dituju**
Tutorial ini ditujukan untuk pengembang dan pelaksana sistem. Anda tidak harus terbiasa dengan Amazon Pinpoint atau Postman untuk menyelesaikan langkah-langkah dalam tutorial ini. Anda harus nyaman mengelola kebijakan IAM dan memodifikasi contoh kode JSON.
Prosedur dalam tutorial ini dirancang untuk mencegah pengguna baru menggunakan operasi API yang dapat menghapus sumber daya Amazon Pinpoint secara permanen. Pengguna tingkat lanjut dapat menghapus batasan ini dengan memodifikasi kebijakan yang terkait dengan penggunanya.
**Fitur yang Digunakan**
Tutorial ini mencakup contoh penggunaan untuk fitur Amazon Pinpoint berikut:
+ Berinteraksi dengan Amazon Pinpoint API dengan menggunakan Postman
**Waktu yang dibutuhkan**
Diperlukan waktu sekitar 15 menit untuk menyelesaikan tutorial ini.
**Pembatasan Regional**
Tidak ada batasan regional yang terkait dengan penggunaan solusi ini.
**Biaya Penggunaan Sumber Daya**
Tidak ada biaya untuk membuat AWS akun. Namun, dengan menerapkan solusi ini, Anda mungkin dikenakan biaya AWS penggunaan jika Anda menggunakan Postman untuk melakukan salah satu hal berikut:
+ Kirim email, SMS, push seluler, atau pesan suara
+ Membuat dan mengirim kampanye
+ Gunakan fitur validasi nomor telepon
Untuk informasi selengkapnya tentang tagihan yang terkait dengan penggunaan Amazon Pinpoint, lihat [harga Amazon Pinpoint](https://aws.amazon.com/pinpoint/pricing/).
# Prasyarat untuk menggunakan Postman dengan Amazon Pinpoint
Sebelum Anda memulai tutorial ini, lengkapi prasyarat berikut:
+ Anda harus memiliki AWS akun. Untuk membuat AWS akun, buka [https://console.aws.amazon.com/](https://console.aws.amazon.com/)dan pilih **Buat AWS akun baru**.
+ Pastikan akun yang Anda gunakan untuk masuk Konsol Manajemen AWS dapat membuat kebijakan dan peran IAM baru.
+ Pastikan Anda memiliki setidaknya satu proyek contoh yang dibuat yang mengaktifkan email dan identitas email terverifikasi. Lihat [Membuat project Amazon Pinpoint dengan dukungan email di Panduan](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-create.html) Pengguna *Amazon Pinpoint*.
+ Pastikan Anda memiliki ID AWS Akun. ID AWS Akun Anda dapat ditemukan di sudut kanan atas konsol atau Anda dapat menggunakan antarmuka baris perintah (CLI). Lihat [Menemukan ID AWS Akun Anda](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId).
+ Anda harus mengunduh dan menginstal Postman di komputer Anda. Anda dapat mengunduh Postman dari situs web [Postman](https://www.getpostman.com).
+ Setelah Anda menginstal Postman di komputer Anda, buat akun Postman. Saat pertama kali memulai aplikasi Postman, Anda diminta untuk masuk atau membuat akun baru. Ikuti instruksi yang diberikan oleh Postman untuk masuk ke akun Anda atau membuat akun jika Anda belum memilikinya.
**Berikutnya**: [Buat kebijakan dan peran IAM](tutorials-using-postman-iam-user.md)
# Buat kebijakan dan peran IAM untuk digunakan dengan Amazon Pinpoint
Saat Anda menggunakan Postman untuk menguji Amazon Pinpoint API, langkah pertama adalah membuat pengguna. Di bagian ini, Anda membuat kebijakan yang memungkinkan pengguna berinteraksi dengan semua sumber daya Amazon Pinpoint. Kemudian, Anda membuat pengguna dan melampirkan kebijakan langsung ke pengguna.
## Buat kebijakan IAM
Pelajari cara membuat kebijakan IAM. Pengguna dan peran yang menggunakan kebijakan ini dapat berinteraksi dengan semua sumber daya di Amazon Pinpoint API. Ini juga menyediakan akses ke sumber daya yang terkait dengan Amazon Pinpoint Email API, serta Amazon Pinpoint SMS dan Voice API.
**Untuk membuat kebijakan**
1. Masuk ke Konsol Manajemen AWS dan buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Di panel navigasi, pilih **Kebijakan** dan kemudian pilih **Buat kebijakan**.
1. Di **Editor kebijakan** pilih **JSON**. Hapus JSON apa pun yang ada di **editor Kebijakan** sehingga kosong. Salin dan tempel JSON berikut ke **editor Kebijakan** dan kemudian di **editor Kebijakan** ganti semua instance *123456789012* dengan ID Anda Akun AWS .
Akun AWS ID Anda dapat ditemukan di sudut kanan atas konsol, atau Anda dapat menggunakan CLI, lihat [Menemukan ID AWS akun Anda](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-identifiers.html#FindAccountId).
**catatan**
Untuk melindungi data di akun Amazon Pinpoint Anda, kebijakan ini hanya menyertakan izin yang memungkinkan Anda membaca, membuat, dan memodifikasi sumber daya. Itu tidak termasuk izin yang memungkinkan Anda untuk menghapus sumber daya. Anda dapat mengubah kebijakan ini dengan menggunakan editor visual di konsol IAM. Untuk informasi selengkapnya, lihat [Mengelola kebijakan IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage.html) di Panduan Pengguna IAM. Anda juga dapat menggunakan [CreatePolicyVersion](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreatePolicyVersion.html)operasi di IAM API untuk memperbarui kebijakan ini.
Selain itu, kebijakan ini mencakup izin yang memungkinkan Anda berinteraksi dengan `sms-voice` layanan `ses` dan layanan, selain `mobiletargeting` layanan. `sms-voice`Izin `ses` dan memungkinkan Anda untuk berinteraksi dengan Amazon Pinpoint Email API dan Amazon Pinpoint SMS dan Voice API, masing-masing. `mobiletargeting`Izin memungkinkan Anda berinteraksi dengan Amazon Pinpoint API.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "VisualEditor0",
"Effect": "Allow",
"Action": [
"mobiletargeting:Update*",
"mobiletargeting:Get*",
"mobiletargeting:Send*",
"mobiletargeting:Put*",
"mobiletargeting:Create*"
],
"Resource": [
"arn:aws:mobiletargeting:*:123456789012:apps/*",
"arn:aws:mobiletargeting:*:123456789012:apps/*/campaigns/*",
"arn:aws:mobiletargeting:*:123456789012:apps/*/segments/*"
]
},
{
"Sid": "VisualEditor1",
"Effect": "Allow",
"Action": [
"mobiletargeting:TagResource",
"mobiletargeting:PhoneNumberValidate",
"mobiletargeting:ListTagsForResource",
"mobiletargeting:CreateApp"
],
"Resource": "arn:aws:mobiletargeting:*:123456789012:*"
},
{
"Sid": "VisualEditor2",
"Effect": "Allow",
"Action": [
"ses:TagResource",
"ses:Send*",
"ses:Create*",
"ses:Get*",
"ses:List*",
"ses:Put*",
"ses:Update*",
"sms-voice:SendVoiceMessage",
"sms-voice:List*",
"sms-voice:Create*",
"sms-voice:Get*",
"sms-voice:Update*"
],
"Resource": "*"
}
]
}
```
------
Pilih **Berikutnya**.
1. Untuk **nama Kebijakan**, masukkan nama untuk kebijakan, seperti**PostmanAccessPolicy**. Pilih **Buat kebijakan**.
1. (Opsional) Anda dapat menambahkan tag ke kebijakan dengan memilih **Tambah Tag**.
1. Pilih **Berikutnya: Tinjauan**.
## Mmebuat pengguna IAM
**Awas**
Pengguna IAM memiliki kredensi jangka panjang, yang menghadirkan risiko keamanan. Untuk membantu mengurangi risiko ini, kami menyarankan agar Anda memberikan pengguna ini hanya izin yang mereka perlukan untuk melakukan tugas dan menghapus pengguna ini ketika mereka tidak lagi diperlukan.
Setelah membuat kebijakan, Anda dapat membuat pengguna dan melampirkan kebijakan tersebut. Saat Anda membuat pengguna, IAM menyediakan serangkaian kredensional yang memungkinkan Postman menjalankan operasi Amazon Pinpoint API.
**Untuk membuat pengguna**
1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Di konsol IAM, di panel navigasi, pilih **Pengguna**, lalu pilih **Buat** pengguna.
1. Di bawah **Rincian pengguna****, untuk nama Pengguna**, masukkan nama yang mengidentifikasi pengguna, seperti**PostmanUser**. Lalu pilih **Selanjutnya**.
1. Di bawah **Setel izin**, untuk **opsi Izin**, pilih **Lampirkan kebijakan** secara langsung.
1. Di bawah **Kebijakan izin**, pilih kebijakan (**PostmanAccessPolicy**) yang Anda buat di [Membuat kebijakan IAM](#tutorials-using-postman-iam-user-create-policy). Lalu pilih **Selanjutnya**.
1. Pada halaman **Tinjau dan buat**, secara opsional tambahkan tag yang membantu Anda mengidentifikasi pengguna. Untuk informasi selengkapnya tentang penggunaan tag, lihat [Menandai sumber daya IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_tags.html) di Panduan Pengguna *IAM*.
1. Saat Anda siap membuat pengguna, pilih **Buat pengguna**.
## Buat kunci akses
**Awas**
Skenario ini mengharuskan pengguna IAM dengan akses terprogram dan kredensi jangka panjang, yang menghadirkan risiko keamanan. Untuk membantu mengurangi risiko ini, kami menyarankan agar Anda memberikan pengguna ini hanya izin yang mereka perlukan untuk melakukan tugas dan menghapus pengguna ini ketika mereka tidak lagi diperlukan. Kunci akses dapat diperbarui jika perlu. Untuk informasi selengkapnya, lihat [Memperbarui kunci akses](https://docs.aws.amazon.com/IAM/latest/UserGuide/id-credentials-access-keys-update.html) di *Panduan Pengguna IAM*.
IAM menyediakan serangkaian kredensi yang dapat Anda gunakan untuk memungkinkan Postman menjalankan operasi Amazon Pinpoint API.
**Untuk membuat pengguna**
1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. **Di konsol IAM, di panel navigasi, pilih Pengguna.** Pilih user (**PostmanUser**) yang dibuat di [Buat pengguna IAM](#tutorials-using-postman-iam-user-create-user), lalu pilih tab **Security credentials**.
1. Pada bagian **Access key**, pilih **Buat access key**.
1. Pada halaman **Praktik & alternatif terbaik kunci Akses**, pilih **Aplikasi yang berjalan di luar AWS**.
Lalu pilih **Selanjutnya**.
1. (Opsional) Anda dapat menambahkan tag deskripsi ke kebijakan.
1. Pilih **Buat access key**.
1. Pada halaman **Ambil kunci akses**, salin kredenal yang ditampilkan di kolom kunci Akses dan **kunci akses** **Rahasia**.
**catatan**
Anda harus memberikan ID kunci akses dan kunci akses rahasia nanti dalam tutorial ini. Ini adalah satu-satunya saat Anda dapat melihat kunci akses rahasia. Kami menyarankan Anda menyalinnya dan menyimpannya di lokasi yang aman.
1. Setelah Anda menyimpan kedua kunci, pilih **Selesai**.
**Berikutnya**: [Mengatur Postman](tutorials-using-postman-configuration.md)
# 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)
# Kirim permintaan ke Amazon Pinpoint API
Setelah selesai mengonfigurasi dan menguji Postman, Anda dapat mulai mengirim permintaan tambahan ke Amazon Pinpoint API. Bagian ini mencakup informasi yang harus Anda ketahui sebelum mulai mengirim permintaan. Ini juga mencakup dua permintaan sampel yang menjelaskan cara menggunakan koleksi Amazon Pinpoint.
**penting**
Saat Anda menyelesaikan prosedur di bagian ini, Anda mengirimkan permintaan ke Amazon Pinpoint API. Permintaan ini membuat sumber daya baru di akun Amazon Pinpoint Anda, mengubah sumber daya yang ada, mengirim pesan, mengubah konfigurasi proyek Amazon Pinpoint Anda, dan menggunakan fitur Amazon Pinpoint lainnya. Berhati-hatilah saat Anda melaksanakan permintaan ini.
## Contoh dalam koleksi Amazon Pinpoint Postman
Anda harus mengonfigurasi sebagian besar operasi dalam koleksi Amazon Pinpoint Postman sebelum Anda dapat menggunakannya. Untuk `GET` dan `DELETE` operasi, Anda biasanya hanya perlu memodifikasi variabel yang diatur pada tab **Pra-permintaan Script**.
**catatan**
Bila Anda menggunakan kebijakan IAM yang ditampilkan di [Buat kebijakan IAM](tutorials-using-postman-iam-user.md#tutorials-using-postman-iam-user-create-policy), Anda tidak dapat menjalankan `DELETE` permintaan apa pun yang disertakan dalam koleksi ini.
Misalnya, `GetCampaign` operasi mengharuskan Anda untuk menentukan a `projectId` dan a`campaignId`. Pada tab **Pra-permintaan Script**, kedua variabel ini hadir, dan diisi dengan nilai contoh. Hapus nilai contoh dan ganti dengan nilai yang berlaku untuk proyek dan kampanye Amazon Pinpoint Anda.
Dari variabel-variabel ini, yang paling umum digunakan adalah `projectId` variabel. Nilai untuk variabel ini harus menjadi pengidentifikasi unik untuk proyek yang permintaan Anda terapkan. Untuk mendapatkan daftar pengidentifikasi ini untuk proyek Anda, lihat respons terhadap `GetApps` permintaan yang Anda kirim pada langkah sebelumnya dari tutorial ini. Dalam tanggapan itu, `Id` bidang menyediakan pengenal unik untuk sebuah proyek. Untuk mempelajari lebih lanjut tentang `GetApps` operasi dan arti dari setiap bidang dalam respons, lihat [Aplikasi di Referensi](https://docs.aws.amazon.com/pinpoint/latest/apireference/apps.html) *API Amazon Pinpoint*.
**catatan**
Di Amazon Pinpoint, “proyek” sama dengan “aplikasi” atau “aplikasi”.
Untuk `POST` dan `PUT` operasi, Anda juga harus memodifikasi badan permintaan untuk menyertakan nilai yang ingin Anda kirim ke API. Misalnya, ketika Anda mengirimkan `CreateApp` permintaan, yang merupakan `POST` permintaan, Anda harus menentukan nama untuk proyek yang Anda buat. Anda dapat memodifikasi permintaan pada tab **Tubuh**. Dalam contoh ini, ganti nilai di sebelahnya `"Name"` dengan nama proyek. Jika Anda ingin menambahkan tag ke proyek, Anda dapat menentukannya di `tags` objek. Atau, jika Anda tidak ingin menambahkan tag, Anda dapat menghapus seluruh `tags` objek.
**catatan**
`UntagResource`Operasi ini juga mengharuskan Anda untuk menentukan parameter URL. Anda dapat menentukan parameter ini pada tab **Params**. Ganti **nilai di kolom VALUE** dengan tag yang ingin Anda hapus untuk sumber daya yang ditentukan.
## Contoh permintaan: Buat proyek dengan menggunakan `CreateApp` operasi
Sebelum Anda membuat segmen dan kampanye di Amazon Pinpoint, Anda harus terlebih dahulu membuat proyek. Di Amazon Pinpoint, sebuah *proyek* terdiri dari segmen, kampanye, konfigurasi, dan data yang disatukan oleh tujuan bersama. Misalnya, Anda dapat menggunakan proyek untuk memuat semua konten yang terkait dengan aplikasi tertentu, atau dengan merek atau inisiatif pemasaran tertentu. Saat Anda menambahkan informasi pelanggan ke Amazon Pinpoint, informasi tersebut terkait dengan proyek.
**Untuk membuat proyek dengan mengirimkan permintaan CreateApp API**
1. Pada menu **Lingkungan**, pilih tempat Wilayah AWS Anda ingin membuat proyek.
![\[\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/userguide/images/Postman_Tutorial_Environments.png)
Dalam contoh ini, Postman telah dikonfigurasi sehingga menu **Lingkungan** menunjukkan empat opsi berikut:
+ AS Timur (Virginia Utara)
+ AS Barat (Oregon)
+ Eropa (Frankfurt)
+ Eropa (Irlandia)
1. Di folder **Aplikasi**, pilih **CreateApp**operasi>.
![\[\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/userguide/images/Postman_Tutorial_3.2_2.png)
Folder **Apps** dalam koleksi Amazon Pinpoint Postman diperluas dan menampilkan permintaan berikut:
+ `GetApp`
+ `GetApps`
+ `CreateApp`
+ `DeleteApp`
1. Pada tab **Body**, di samping`"Name"`, ganti nilai placeholder (`"string"`) dengan nama untuk kampanye, seperti. **"MySampleProject"**
1. Hapus koma setelah nama kampanye, lalu hapus seluruh `tags` objek pada baris 3 hingga 5. Ketika Anda selesai, permintaan Anda harus menyerupai contoh yang ditampilkan dalam cuplikan kode berikut.
```
{
"Name": "MySampleProject"
}
```
Postman dikonfigurasi untuk mengirim permintaan sebagai payload JSON mentah.
1. Pilih **Kirim**. Jika kampanye berhasil dibuat, panel respons akan menampilkan status. `201 Created`
```
{
"Name": "MySampleProject"
"Id": "12345678901234567890123456789012",
"Arn": "arn:aws:mobiletargeting:us-east-1:123456789012:apps/12345678901234567890123456789012",
"tags": {}
}
```
## Contoh: Kirim email dengan menggunakan `SendMessages` operasi
Sangat umum untuk menggunakan Amazon Pinpoint `SendMessages` API untuk mengirim pesan transaksional. Salah satu keuntungan mengirim pesan dengan menggunakan `SendMessages` API sebagai lawan membuat kampanye, adalah Anda dapat mengirim pesan ke alamat apa pun, seperti alamat email, nomor telepon, atau token perangkat. Alamat yang Anda kirimi pesan tidak harus ada di akun Amazon Pinpoint Anda. Mari kita bandingkan metode ini dengan mengirim pesan dengan membuat kampanye. Sebelum mengirim kampanye di Amazon Pinpoint, Anda harus menambahkan titik akhir ke akun Amazon Pinpoint, membuat segmen, membuat kampanye, dan menjalankan kampanye.
Contoh di bagian ini menunjukkan cara mengirim pesan email transaksional langsung ke alamat email tertentu. Anda dapat mengubah permintaan ini untuk mengirim pesan melalui saluran lain, seperti SMS, push seluler, atau suara.
**Untuk mengirim pesan email dengan mengirimkan permintaan SendMessages**
1. Verifikasi bahwa saluran email diaktifkan untuk proyek dan alamat email atau domain yang ingin Anda gunakan untuk mengirim dan menerima pesan dikonfigurasi. *Untuk informasi selengkapnya, lihat [Mengaktifkan dan menonaktifkan saluran email](pinpoint/latest/userguide/channels-email-setup.html) dan [Memverifikasi identitas email di Panduan Pengguna](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-manage-verify.html) Amazon Pinpoint.*
**catatan**
Untuk menyelesaikan prosedur di bagian ini, Anda harus memverifikasi dan alamat email
1. Pada menu **Lingkungan**, pilih Wilayah AWS yang ingin Anda kirimi pesan.
Dalam contoh ini, Postman telah dikonfigurasi sehingga menu **Lingkungan** menunjukkan empat opsi berikut:
+ AS Timur (Virginia Utara)
+ AS Barat (Oregon)
+ Eropa (Frankfurt)
+ Eropa (Irlandia)
1. Di folder **Pesan**, pilih **SendMessages**operasi.
![\[\]](http://docs.aws.amazon.com/id_id/pinpoint/latest/userguide/images/Postman_Tutorial_3.3_3.png)
1. Pada tab **Pra-permintaan Script**, ganti nilai `projectId` variabel dengan ID proyek yang sudah ada di Wilayah yang Anda pilih di langkah 2 bagian ini.
1. Pada tab **Body**, hapus permintaan contoh yang ditampilkan di editor permintaan. Tempel kode berikut:
```
{
"MessageConfiguration":{
"EmailMessage":{
"FromAddress":"sender@example.com",
"SimpleEmail":{
"Subject":{
"Data":"Sample Amazon Pinpoint message"
},
"HtmlPart":{
"Data":"Test message
This is a sample message sent from Amazon Pinpoint using the SendMessages API.
"
},
"TextPart":{
"Data":"This is a sample message sent from Amazon Pinpoint using the SendMessages API."
}
}
}
},
"Addresses":{
"recipient@example.com": {
"ChannelType": "EMAIL"
}
}
}
```
1. Pada kode sebelumnya, ganti *sender@example.com* dengan alamat email terverifikasi Anda. Ganti *recipient@example.com* dengan alamat email terverifikasi yang ingin Anda kirimi pesan.
**catatan**
Jika akun Anda masih dalam kotak pasir email Amazon Pinpoint, Anda hanya dapat mengirim email ke alamat atau domain yang diverifikasi di akun Amazon Pinpoint Anda. Untuk informasi selengkapnya tentang menghapus akun Anda dari kotak pasir, lihat [Meminta akses produksi untuk email di Panduan](https://docs.aws.amazon.com/pinpoint/latest/userguide/channels-email-setup-production-access.html) Pengguna *Amazon Pinpoint*.
1. Pilih **Kirim**. Jika pesan berhasil dikirim, panel respons menampilkan status. `200 OK`
```
{
"ApplicationId": "12345678901234567890123456789012",
"RequestId": "",
"Result": {
"recipient@example.com": {
"DeliveryStatus": "SUCCESSFUL",
"StatusCode": 200,
"StatusMessage": "",
"MessageId": ""
}
}
}
```