Perpustakaan ini memberikan dukungan untuk aplikasi Ruby Shopify untuk mengakses API Admin Shopify, dengan memudahkan melakukan tindakan berikut:
Selain API admin, perpustakaan ini juga memungkinkan permintaan API etalase.
Anda dapat menggunakan perpustakaan ini dalam aplikasi apa pun yang memiliki backend ruby, karena tidak bergantung pada kerangka kerja tertentu - Anda dapat memasukkannya di samping tumpukan pilihan Anda dan menggunakan fitur yang Anda butuhkan untuk membangun aplikasi Anda.
Catatan : Instruksi ini berlaku untuk V10 atau lebih baru dari paket ini. Jika Anda menjalankan V9 di aplikasi Anda, Anda dapat menemukan dokumentasi di cabang ini.
Jika menggunakan dalam kerangka kerja Rails, kami sangat menyarankan Anda menggunakan permata Shopify_app untuk berinteraksi dengan permata ini. Otentikasi, penyimpanan sesi, pendaftaran webhook, dan jalur lain yang sering diimplementasikan dikelola dalam permata itu dengan konfigurasi yang mudah digunakan.
Untuk mengikuti panduan penggunaan ini, Anda perlu:
Tambahkan yang berikut ke gemfile Anda:
gem " shopify_api "
Atau gunakan Bundler:
bundle add shopify_api
Mulailah dengan menginisialisasi ShopifyAPI::Context
dengan parameter aplikasi Anda dengan menelepon ShopifyAPI::Context.setup
(contoh di bawah) ketika aplikasi Anda dimulai (misalnya application.rb
dalam aplikasi rel).
ShopifyAPI :: Context . setup (
api_key : "<api-key>" ,
api_secret_key : "<api-secret-key>" ,
host : "<https://application-host-name.com>" ,
scope : "read_orders,read_products,etc" ,
is_embedded : true , # Set to true if you are building an embedded app
api_version : "2022-01" , # The version of the API you would like to use
is_private : false , # Set to true if you have an existing private app
)
Anda harus melalui OAuth seperti yang dijelaskan di sini untuk membuat sesi untuk toko -toko menggunakan aplikasi Anda. Permata API Shopify mencoba memudahkan ini dengan menyediakan fungsi untuk memulai dan menyelesaikan proses OAuth. Lihat OAuth Doc untuk instruksi tentang cara menggunakan ini.
Jika Anda bermaksud menggunakan webhooks di aplikasi Anda, ikuti langkah -langkah di WebHooks Doc untuk instruksi untuk mendaftar dan menangani Webhooks.
Setelah aplikasi Anda dapat melakukan oauth, sekarang dapat membuat panggilan API Shopify yang diautentikasi, lihat dokumen untuk:
Lihat Breaking_Changes_for_v15
Lihat Breaking_Changes_for_v10
Lihat Breaking_Changes_for_older_versions
Setelah mengkloning repositori, Anda dapat menginstal dependensi dengan Bundler:
bundle install
Untuk menjalankan tes otomatis:
bundle exec rake test
Kami menggunakan RuboCop untuk memasukkan/memformat kode. Anda dapat menjalankannya dengan perintah berikut:
bundle exec rubocop