/example-ruby-app

Example application written in Ruby for API documentation.

Primary LanguageRubyMIT LicenseMIT

Shopify App Examples

This repository is home to the code examples highlighted in various Shopify API tutorials. They are designed solely for the purpose of introducing new developers to the Shopify API. The example apps are written in Sinatra, but the concepts presented will also apply to developers building applications in other languages such as Python, Node.js and PHP.

Tutorial index

1 Getting Started: Building a public Shopify application (tutorial)

2 Charging For Your App: Adding billing to your app (tutorial)

Requirements

Credentials

Follow this guide to obtain your public app credentials from your Shopify Partners account.

This example app uses a .env file to store app credentials. After cloning the repository, create a .env file in the root folder (/example-ruby-app) using the code snippet below. Then, copy the values of the API Key and API Secret from your partner dashboard, and use them as the values in .env.

API_KEY=YOUR_API_KEY
API_SECRET=YOUR_SECRET_KEY

YOUR_API_KEY and YOUR_SECRET_KEY are the values you must replace.

App URL

This tutorial series uses ngrok to create a secure tunnel from the internet to your local machine. For each installment in the series, you will need to copy the APP_URL generated by ngrok to your app.rb file. Additionally, the APP_URL needs to be added to the App URLs section of your public app settings. These procedures are covered in the Building a public Shopify application tutorial.

Running the app

bundle install
ruby 01\ Getting\ Started/app.rb