Integrasi Etsy Open API

Bagaimana Riset Listing Menggunakan Data Etsy

Alur yang transparan dari otorisasi pemilik toko hingga data ditampilkan di dashboard, dengan akses minimum dan kontrol tetap pada pengguna.

Terakhir diperbarui: 23 September 2026

  • Open API v3Sumber integrasi resmi
  • OAuth 2.0 + PKCETanpa menyimpan password Etsy
  • 6 jam / 24 jamBatas kesegaran tampilan
PRINSIP INTEGRASI

Data digunakan sesuai izin dan fungsi yang dipilih

Riset Listing membatasi akses, memisahkan data publik dan privat, serta menyediakan jalur disconnect dan penghapusan.

01

Koneksi berbasis izin

Koneksi toko dilakukan melalui OAuth Etsy; password Etsy tidak pernah diminta atau disimpan.

02

Data minimum

Scope diminta sesuai kebutuhan fitur dan tidak mencakup buyer_email.

03

Cache terbatas

Cache digunakan untuk efisiensi dan diperbarui mengikuti batas kesegaran Etsy.

04

Kontrol pengguna

Pemilik toko dapat menolak izin, disconnect, atau meminta penghapusan data.

ALUR DATA

Dari Etsy ke dashboard dalam empat langkah

Setiap tahap memiliki tujuan yang jelas dan tetap mengikuti scope yang disetujui pemilik toko.

  1. 01
    Otorisasi Etsy

    Pengguna menyetujui scope pada halaman Etsy.

  2. 02
    Akses terbatas

    Server meminta data yang diperlukan melalui Open API.

  3. 03
    Pemrosesan

    Data disusun untuk fitur yang diminta pengguna.

  4. 04
    Kontrol pengguna

    Hasil ditampilkan, dengan opsi disconnect dan hapus.

PRAKTIK PENGGUNAAN DATA

Cara integrasi dijalankan dan dilindungi

Rincian ini menjelaskan sumber data, izin, batas penyimpanan, larangan penggunaan, keamanan, dan kanal resmi pengguna.

Sumber Data dan Status Aplikasi

Fitur yang membutuhkan data Etsy menggunakan Etsy Open API v3. Riset Listing adalah aplikasi independen yang dikembangkan oleh Atep Saepulloh (profil pengembang Riset Listing) dan bukan agen, perwakilan, pegawai, partner, atau bagian dari Etsy.

Otorisasi OAuth 2.0 dengan PKCE

Koneksi toko dimulai oleh pengguna dan diselesaikan pada halaman otorisasi Etsy. Riset Listing tidak meminta, menerima, atau menyimpan kombinasi ID dan password Etsy. Token hanya digunakan oleh server untuk fungsi yang disetujui.

Scope dan Tujuannya

Akses minimum yang diminta adalah shops_r untuk identitas toko, shops_w untuk mengubah pengaturan toko hanya setelah tindakan pengguna, listings_r untuk membaca listing milik toko, listings_w untuk membuat, mengedit, mengunggah, dan memublikasikan listing setelah tindakan pengguna, listings_d untuk menghapus listing secara permanen hanya setelah konfirmasi pengguna, transactions_r untuk pembukuan serta informasi transaksi, dan feedback_r untuk ulasan. Riset Listing tidak meminta profile_r atau buyer_email.

Data Publik dan Data Privat

Data publik digunakan sebagai bahan riset yang dapat berubah. Data privat—termasuk order, transaksi, dan informasi akun toko—hanya diproses dalam konteks akun pemilik toko yang memberikan izin. Data privat tidak dijual, tidak dijadikan database riset publik, dan tidak ditampilkan kepada pengguna lain.

Cache dan Kesegaran Tampilan

Cache operasional mengurangi permintaan API berulang dan disimpan hanya selama diperlukan untuk menyediakan layanan. Tampilan dirancang agar konten listing tidak lebih dari enam jam tertinggal dari Etsy dan konten Etsy lainnya tidak lebih dari 24 jam tertinggal. Waktu sinkronisasi ditampilkan pada fitur yang relevan.

Tanpa Scraping atau Otomasi Tidak Sah

Riset Listing tidak menggunakan screen scraping sebagai pengganti Etsy API dan tidak menyediakan metode tidak sah untuk mengakses, menganalisis, atau mengambil data Etsy. Data diperoleh melalui endpoint dan izin yang berlaku.

Analitik, Machine Learning, dan AI

Riset Listing tidak menggunakan data Etsy untuk melatih model AI. Data yang diperoleh melalui Etsy API tidak digunakan untuk analytics, machine learning, atau pemrosesan AI kecuali izin tertulis Etsy secara tegas mencakup penggunaan tersebut. Jika penggunaan telah disetujui, data dibatasi pada konteks minimum dan output tetap harus ditinjau pengguna.

Keamanan Token dan Data

Komunikasi API menggunakan HTTPS, token OAuth dienkripsi saat disimpan, dan akses dibatasi berdasarkan akun serta sesi. Token tidak dimasukkan ke URL publik, tidak ditampilkan kepada pengguna lain, dan tidak dipindahtangankan atau dikomersialkan kepada pihak ketiga.

Rate Limit dan Stabilitas

Aplikasi mengikuti rate limit Etsy, menggunakan cache yang masih valid, dan dapat menunda refresh ketika diperlukan untuk menjaga stabilitas. Limit paket pengguna dikelola terpisah dan dijelaskan dalam Kebijakan Fair Usage.

Disconnect, Pencabutan, dan Penghapusan

Pengguna dapat melakukan disconnect dari menu Connected Shop atau mencabut izin dari pengaturan akun Etsy. Disconnect menghentikan penggunaan token tanpa menghapus akun Etsy. Permintaan penghapusan akun dan data tersedia melalui Penghapusan Data atau legal@risetlisting.com.

Insiden Keamanan

Jika data Etsy Member diketahui atau diduga terkompromi, Riset Listing akan membatasi dampak, menyelidiki, dan mengirim pemberitahuan yang diwajibkan. Etsy dan seller yang terdampak akan diberi tahu segera dan paling lambat 24 jam setelah penemuan insiden yang relevan.

Referensi dan Kontak Resmi

Implementasi mengacu pada dokumentasi Etsy Open API, panduan autentikasi, dan Etsy API Terms of Use. Pertanyaan produk dapat dikirim ke support@risetlisting.com; pertanyaan privasi, data, atau keamanan ke legal@risetlisting.com.

SIAP MULAI RISET?

Ubah data yang tersedia menjadi keputusan yang lebih terarah.

Mulai Sekarang