Разработка приложений Shopify стала проще благодаря HTTP API и Guzzle

Пользователь может убедиться, что на странице отображается правильное имя приложения и области, которые вы запросили. Если все правильно, пользователь может нажать кнопку « Установить приложение» , чтобы установить приложение.

Оттуда Shopify генерирует код доступа и HMAC (код аутентификации сообщения с хеш-ключом). Они передаются вместе с shop , timestamp и state на ваш URL перенаправления. В приложении вы можете использовать эту информацию, чтобы убедиться, что запрос действителен.

Страница авторизации

Как только Shopify перенаправляет на URL перенаправления, вы несете ответственность за проверку правильности запроса. Если он действителен, сделайте запрос на токен доступа. Создайте файл auth.php в корне вашего рабочего каталога и добавьте следующий код:

 <?php require 'vendor/autoload.php'; use Carbon\Carbon; use GuzzleHttp\Client; $dotenv = new Dotenv\Dotenv(__DIR__); $dotenv->load(); $db = new Mysqli(getenv('MYSQL_HOST'), getenv('MYSQL_USER'), getenv('MYSQL_PASS'), getenv('MYSQL_DB')); $api_key = getenv('SHOPIFY_APIKEY'); $secret_key = getenv('SHOPIFY_SECRET'); $query = $_GET; if (!isset($query['code'], $query['hmac'], $query['shop'], $query['state'], $query['timestamp'])) { exit; //or redirect to an error page } $one_minute_ago = Carbon::now()->subSeconds(60)->timestamp; if ($query['timestamp'] < $one_minute_ago) { exit; //or redirect to an error page } $hmac = $query['hmac']; $store = $query['shop']; unset($query['hmac']); foreach ($query as $key => $val) { $params[] = "$key=$val"; } asort($params); $params = implode('&', $params); $calculated_hmac = hash_hmac('sha256', $params, $secret_key); if($hmac == $calculated_hmac){ $client = new Client(); $response = $client->request( 'POST', "https://{$store}/admin/oauth/access_token", [ 'form_params' => [ 'client_id' => $api_key, 'client_secret' => $secret_key, 'code' => $query['code'] ] ] ); $data = json_decode($response->getBody()->getContents(), true); $access_token = $data['access_token']; $nonce = $query['state']; if ($select = $db->prepare("SELECT id FROM installs WHERE store = ? AND nonce = ?")) { $select->bind_param('ss', $store, $nonce); $select->execute(); $select->bind_result($id); $select->fetch(); $select->close(); if ($id > 0) { $db->query("UPDATE installs SET access_token = '$access_token' WHERE id = '$id'"); } } } с <?php require 'vendor/autoload.php'; use Carbon\Carbon; use GuzzleHttp\Client; $dotenv = new Dotenv\Dotenv(__DIR__); $dotenv->load(); $db = new Mysqli(getenv('MYSQL_HOST'), getenv('MYSQL_USER'), getenv('MYSQL_PASS'), getenv('MYSQL_DB')); $api_key = getenv('SHOPIFY_APIKEY'); $secret_key = getenv('SHOPIFY_SECRET'); $query = $_GET; if (!isset($query['code'], $query['hmac'], $query['shop'], $query['state'], $query['timestamp'])) { exit; //or redirect to an error page } $one_minute_ago = Carbon::now()->subSeconds(60)->timestamp; if ($query['timestamp'] < $one_minute_ago) { exit; //or redirect to an error page } $hmac = $query['hmac']; $store = $query['shop']; unset($query['hmac']); foreach ($query as $key => $val) { $params[] = "$key=$val"; } asort($params); $params = implode('&', $params); $calculated_hmac = hash_hmac('sha256', $params, $secret_key); if($hmac == $calculated_hmac){ $client = new Client(); $response = $client->request( 'POST', "https://{$store}/admin/oauth/access_token", [ 'form_params' => [ 'client_id' => $api_key, 'client_secret' => $secret_key, 'code' => $query['code'] ] ] ); $data = json_decode($response->getBody()->getContents(), true); $access_token = $data['access_token']; $nonce = $query['state']; if ($select = $db->prepare("SELECT id FROM installs WHERE store = ? AND nonce = ?")) { $select->bind_param('ss', $store, $nonce); $select->execute(); $select->bind_result($id); $select->fetch(); $select->close(); if ($id > 0) { $db->query("UPDATE installs SET access_token = '$access_token' WHERE id = '$id'"); } } } 

Разбирая код, приведенный выше, сначала проверьте, переданы ли все ожидаемые параметры в URL:

 $query = $_GET; if (!isset($query['code'], $query['hmac'], $query['shop'], $query['state'], $query['timestamp'])) { exit; //or redirect to an error page } 

Сохраните значение hmac в переменной, потому что вам нужно удалить его из массива параметров запроса. Затем переберите оставшиеся параметры, чтобы создать массив, содержащий пару ключ-значение.

 $hmac = $query['hmac']; unset($query['hmac']); $params = []; foreach ($query as $key => $val) { $params[] = "$key=$val"; } с $hmac = $query['hmac']; unset($query['hmac']); $params = []; foreach ($query as $key => $val) { $params[] = "$key=$val"; } 

Сортируйте полученный массив и преобразуйте его в строку:

 asort($params); $params = implode('&', $params); 

Рассчитайте hmac на основе параметров и секретного ключа приложения Shopify:

 $calculated_hmac = hash_hmac('sha256', $params, $secret_key); 

Если значение сгенерированного hmac совпадает со значением, переданным в качестве параметра запроса, вы уверены, что запрос поступил из Shopify. Оттуда сделайте запрос на токен постоянного доступа от Shopify API и сохраните его в базе данных:

 $store = $query['shop']; if($hmac === $calculated_hmac){ $client = new Client(); $response = $client->request( 'POST', "https://{$store}/admin/oauth/access_token", [ 'form_params' => [ 'client_id' => $api_key, 'client_secret' => $secret_key, 'code' => $query['code'] ] ] ); $data = json_decode($response->getBody()->getContents(), true); $access_token = $data['access_token']; $nonce = $query['state']; if ($select = $db->prepare("SELECT id FROM installs WHERE store = ? AND nonce = ?")) { $select->bind_param('ss', $store, $nonce); $select->execute(); $select->bind_result($id); $select->fetch(); $select->close(); if ($id > 0) { $db->query("UPDATE installs SET access_token = '$access_token' WHERE id = '$id'"); } } } 

Делать запросы к API

Теперь, когда вы приобрели токен доступа, вы можете отправлять запросы API от имени пользователя. Токен доступа похож на ключ от магазина пользователя. Он дает вам доступ для чтения и записи к любой из конечных точек, перечисленных на странице справки API, если это часть разрешений, которые вы запрашивали, когда пользователь установил приложение.

Также обратите внимание, что конечные точки с меткой «Shopify Plus» доступны только для продавцов Shopify Plus . Это означает, что оно доступно приложению только в том случае, если пользователь, установивший его, является продавцом Shopify Plus.

Чтобы продемонстрировать, как делать запросы к API-интерфейсу Shopify, вы создадите страницу, которая показывает список продуктов, которые вы добавили в магазин. Начните с создания файла products.php и добавьте следующий код:

 <?php require 'vendor/autoload.php'; use GuzzleHttp\Client; $dotenv = new Dotenv\Dotenv(__DIR__); $dotenv->load(); $db = new Mysqli(getenv('MYSQL_HOST'), getenv('MYSQL_USER'), getenv('MYSQL_PASS'), getenv('MYSQL_DB')); $store = 'test-shop.myshopify.com'; $select = $db->query("SELECT access_token FROM installs WHERE store = '$store'"); $user = $select->fetch_object(); $access_token = $user->access_token; $client = new Client(); $response = $client->request( 'GET', "https://{$store}/admin/products.json", [ 'query' => [ 'fields' => 'id,images,title,variants', 'access_token' => $access_token ] ] ); $result = json_decode($response->getBody()->getContents(), true); $loader = new Twig_Loader_Filesystem('templates'); $twig = new Twig_Environment($loader, [ 'cache' => 'cache', 'debug' => true ]); $template = $twig->loadTemplate('products.html'); echo $template->render(['products' => $result['products']]); 

Разбирая код выше, сначала получите токен доступа из базы данных. Для быстрой демонстрации, название магазина Shopify жестко закодировано. Для приложений Shopify, которые отображают данные из магазина Shopify, обычно используется имя домена веб-сайта, используемого для отображения данных.

 $store = 'test-shop.myshopify.com'; $select = $db->query("SELECT access_token FROM installs WHERE store = '$store'"); $user = $select->fetch_object(); $access_token = $user->access_token; 

Затем сделайте запрос к конечной точке продукта . Обратите внимание, что основным URL-адресом является название магазина: https://test-shop.myshopify.com . Это означает, что базовый URL отличается для каждого магазина, поэтому важно сохранить имя магазина в базе данных, чтобы вы могли обратиться к нему позже. При access_token запросов к API вам всегда нужно access_token . Для запросов GET вы можете предоставить его в качестве параметра query . Для запросов POST добавьте его в виде form_params .

Конечная точка продуктов не требует, чтобы что-либо указывалось в качестве параметра запроса, хотя ниже указан параметр fields для указания полей, которые вы хотите вернуть. Если вы не укажете параметр fields , он вернет все поля продукта (например, название, изображения, описание). Вы также можете отфильтровать и ограничить результаты, указав любой из этих параметров .

 $client = new Client(); $response = $client->request( 'GET', "https://{$store}/admin/products.json", [ 'query' => [ 'fields' => 'id,images,title,variants', 'access_token' => $access_token ] ] ); $result = json_decode($response->getBody()->getContents(), true); 

Это дает следующий результат при распечатке:

 Array ( [products] => Array ( [0] => Array ( [id] => 6664000769 [title] => Arduino Uno [images] => Array ( [0] => Array ( [id] => 12780821761 [product_id] => 6664000769 [position] => 1 [created_at] => 2016-06-21T07:31:02-04:00 [updated_at] => 2016-06-21T07:31:02-04:00 [src] => https://cdn.shopify.com/s/files/1/1354/0873/products/uno.jpg?v=1466508662 [variant_ids] => Array ( ) ) ) ) [1] => Array ( [id] => 6663985537 [title] => Raspberry Pi 3 Model B Motherboard [images] => Array ( [0] => Array ( [id] => 12780794177 [product_id] => 6663985537 [position] => 1 [created_at] => 2016-06-21T07:29:10-04:00 [updated_at] => 2016-06-21T07:29:10-04:00 [src] => https://cdn.shopify.com/s/files/1/1354/0873/products/berry.jpg?v=1466508550 [variant_ids] => Array ( ) ) ) ) ) ) 

Но вы на самом деле не будете распечатывать результат — вы передаете данные результата в шаблон и визуализируете страницу:

 $loader = new Twig_Loader_Filesystem('templates'); $twig = new Twig_Environment($loader, [ 'cache' => 'cache', 'debug' => true ]); $template = $twig->loadTemplate('products.html'); echo $template->render(['products' => $result['products']]); 

Вот содержимое шаблона ( templates/products.html ):

 <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Products</title> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/picnic/6.1.1/picnic.min.css"> <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/picnic/6.1.1/plugins.min.css"> <link rel="stylesheet" href="css/style.css"> </head> <body> <nav> <a href="#" class="brand"> <span>Shopify App</span> </a> </nav> <main> <h1>Products</h1> <div class="flex two"> {% for prod in products %} <div> <article class="card"> <img src="{{ prod.images[0].src }}"> <section> <h3>{{ prod.title }}</h3> <strong>{{ prod.variants[0].price }} PHP</strong> </section> </article> </div> {% endfor %} </div> </main> </body> </html> 

Вывод

Это оно! В этом уроке вы узнали основы разработки приложения Shopify. Как вы уже видели, разработка приложения Shopify очень похожа на разработку стандартного приложения PHP. Единственное отличие состоит в том, что вы используете API-интерфейс Shopify для манипулирования данными из магазина Shopify, а не непосредственно из базы данных.

В следующем посте мы сделаем вещи более интересными, создав более сложное приложение и используя структуру для некоторой правильной структуры кода.

Вы используете Shopify? Как у вас получилось?