View a markdown version of this page

Mengintegrasikan API Mitra Penjualan Amazon - AWS Panduan Preskriptif
Mendaftar sebagai pengembang SP-APIMinta peran SP-APIDaftarkan aplikasi AndaPilih model otorisasiConnect ke SP-API

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

Mengintegrasikan API Mitra Penjualan Amazon

Untuk mengakses data melalui Amazon Selling Partner API (SP-API), Anda harus menyelesaikan tindakan berikut:

  1. Mendaftar sebagai pengembang SP-API

  2. Minta peran SP-API

  3. Daftarkan aplikasi Anda

  4. Pilih model otorisasi untuk aplikasi Anda

  5. Connect ke SP-API

Mendaftar sebagai pengembang SP-API

Sebelum Anda dapat mendaftarkan aplikasi SP-API Anda, Anda harus membuat akun pengembang Amazon dan mendaftar sebagai pengembang SP-API. Untuk gambaran menyeluruh tentang proses registrasi developer, lihat Ikhtisar Pendaftaran SP-API di dokumentasi SP-API.

Minta peran SP-API

Peran SP-API menentukan apakah pengembang atau aplikasi memiliki akses ke operasi atau sumber daya tertentu. Sebagai pengembang, Anda harus meminta dan memenuhi syarat untuk peran tertentu, atau Anda tidak akan dapat mengakses operasi dan sumber daya yang dikelompokkan di bawah peran itu.

Peran melindungi akses ke informasi identitas pribadi (PII) dan data sensitif lainnya. Mereka membatasi akses data untuk memastikan bahwa pengembang hanya dapat mengakses data yang diperlukan untuk aplikasi mereka. Ini membantu melindungi data pelanggan dan menjaga kepercayaan pelanggan.

Mengakses data yang tersedia dalam laporan analisis merek mengharuskan Anda memiliki peran Brand Analytics. Untuk informasi selengkapnya tentang meminta akses ke peran, lihat Bagaimana cara meminta dan memenuhi syarat untuk peran dalam dokumentasi SP-API.

Daftarkan aplikasi Anda

Proses pendaftaran sedikit bervariasi tergantung pada jenis aplikasi. Untuk keperluan pendaftaran, aplikasi dikategorikan sebagai salah satu dari jenis berikut:

  • Aplikasi publik dan aplikasi penjual pribadi — Ini adalah aplikasi yang tersedia untuk umum dan disahkan oleh penjual atau vendor, atau mereka adalah aplikasi penjual yang hanya tersedia untuk organisasi Anda dan diotorisasi sendiri.

  • Aplikasi vendor pribadi — Ini adalah aplikasi vendor yang hanya tersedia untuk organisasi Anda dan diotorisasi sendiri.

Untuk informasi selengkapnya, lihat Mendaftarkan aplikasi Anda di dokumentasi SP-API.

Pilih model otorisasi untuk aplikasi Anda

Model otorisasi untuk API Mitra Penjualan didasarkan pada Login with Amazon, implementasi Amazon OAuth 2.0. Aplikasi Anda diizinkan melalui interaksi dengan halaman yang ditampilkan oleh Amazon dan situs web Anda. Browser web adalah agen pengguna yang melewati parameter antara situs web Anda dan Amazon pada setiap tindakan mitra penjualan. Untuk menerapkan OAuth otorisasi, Anda harus mengonfigurasi situs web Anda untuk menerima dan memproses parameter yang diteruskan Amazon kepadanya. Anda juga harus mengonfigurasi situs web Anda untuk mengarahkan browser web dan meneruskan parameter ke Amazon. Untuk informasi selengkapnya tentang otorisasi, lihat Mengotorisasi aplikasi API Mitra Jual dalam dokumentasi SP-API.

Memahami otorisasi aplikasi

Untuk keperluan otorisasi, ada tiga jenis aplikasi:

  • Aplikasi publik untuk penjual — Aplikasi ini tersedia untuk umum dan disahkan oleh penjual. Anda dapat memilih salah satu alur kerja otorisasi berikut:

  • Aplikasi publik untuk vendor — Aplikasi ini tersedia untuk umum dan disahkan oleh vendor. Anda dapat menggunakan alur kerja otorisasi Situs Web. Ini adalah alur kerja OAuth otorisasi yang dimulai dari situs web Anda sendiri.

  • Aplikasi pribadi untuk penjual atau vendor — Aplikasi ini hanya tersedia untuk organisasi Anda. Ini bisa berupa aplikasi penjual atau vendor. Anda dapat menggunakan pendekatan otorisasi diri. Ketika Anda membuat aplikasi pribadi untuk organisasi Anda sendiri, Anda dapat mengotorisasi sendiri untuk mengakses informasi akun Anda. Anda dapat mengotorisasi sendiri aplikasi Anda dalam status draf; tidak ada alasan untuk menerbitkan aplikasi pribadi. Untuk informasi tentang mencabut otorisasi mandiri dari aplikasi penjual dan vendor, lihat Mencabut otorisasi mandiri dalam dokumentasi SP-API.

Otorisasi grup vendor untuk akses aplikasi

Saat Anda mengotorisasi aplikasi API Mitra Jual untuk mengakses data Anda, Anda memberikan akses ke grup vendor yang terkait dengan kredensi masuk untuk akun Pusat Vendor Anda. Dengan ekstensi, Anda memberikan akses ke semua kode vendor yang ada di grup vendor. Oleh karena itu, penting untuk menggunakan kredensi Pusat Vendor dan grup vendor yang tepat untuk integrasi API Mitra Penjualan Anda.

Grup vendor adalah akun yang Anda masuki. Bergantung pada perjanjian bisnis Anda, model operasi, dan faktor lainnya, grup vendor Anda dapat menyertakan satu atau lebih kode vendor. Setiap kode vendor memungkinkan Anda untuk membuat daftar produk dalam kategori tertentu, atau termasuk perjanjian bisnis yang diperlukan, seperti satu kode vendor untuk merek tertentu.

Anda dapat memiliki beberapa otorisasi untuk setiap grup vendor, atau Anda dapat membuat grup vendor tunggal yang berisi semua kode vendor Anda. Opsi untuk menggunakan beberapa grup vendor yang terkait dengan profil Anda memberi Anda kemampuan untuk menggunakan aplikasi dengan kode vendor yang sama di grup vendor yang berbeda. Dengan opsi ini, Anda tidak perlu mengirimkan beberapa aplikasi pengembang vendor untuk setiap grup vendor.

Untuk informasi selengkapnya, lihat Mengotorisasi grup vendor untuk akses aplikasi dalam dokumentasi SP-API.

Connect ke SP-API

Setelah Anda mendaftarkan dan mengotorisasi aplikasi Anda, Anda dapat mulai mengajukan permintaan. Untuk informasi selengkapnya, lihat Menghubungkan ke API Mitra Jual di dokumentasi SP-API.