Mengintegrasikan Mitra Penjualan Amazon API

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

1. Mendaftar sebagai SP- API developer

2. Minta API peran SP-

3. Daftarkan aplikasi Anda

4. Pilih model otorisasi untuk aplikasi Anda

5. Connect ke SP- API

Mendaftar sebagai SP- API developer

Sebelum Anda dapat mendaftarkan API aplikasi SP- Anda, Anda harus membuat akun pengembang Amazon dan mendaftar sebagai API pengembang SP. Untuk ikhtisar komprehensif tentang proses pendaftaran pengembang, lihat SP- Ikhtisar API Pendaftaran dalam API dokumentasi SP-.

Minta API peran SP-

APIPeran SP 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 yang dapat diidentifikasi secara 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 Daftarkan aplikasi Anda di API dokumentasi SP-.

Pilih model otorisasi untuk aplikasi Anda

Model otorisasi untuk Mitra Penjualan API 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 API aplikasi Mitra Penjualan 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:

  • Alur kerja otorisasi Appstore Mitra Jual — Alur kerja OAuth otorisasi yang dimulai dari halaman detail Appstore Mitra Jual.

  • Alur kerja otorisasi situs web — Alur kerja OAuth otorisasi yang dimulai dari situs web Anda sendiri.

• 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 diri dari aplikasi penjual dan vendor, lihat Mencabut otorisasi mandiri dalam dokumentasi SP. API

Otorisasi grup vendor untuk akses aplikasi

Ketika Anda mengotorisasi API aplikasi 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 Mitra API Jual 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 API dokumentasi SP-.

Connect ke SP- API

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