Introducing a new Node library for accessing the Shopify Admin API

Liam
Shopify Staff
Shopify Staff
651 18 245

Hi App Developer Community,


The new Shopify Admin API library for Node is here! This library makes interacting with the Admin API easy and works with any backend framework (Koa, Express, etc). 

This new library includes all the key features we believe developers are looking for when building a Shopify app, including:

  •   JWT Based Authentication
  •   REST / GraphQL Clients
  •   GraphQL Proxy 
  •   Cursor Based Pagination
  •   Webhooks subscription helpers and HMAC validation 

The existing `koa-shopify-auth` package has also been updated to use this new library [migration guide here], as well as our Node & React tutorial and the Shopify App CLI. For some more examples of its usage, please visit the Getting started guide in the GitHub repository.

The future of Shopify Admin API libraries

Shopify is actively updating all our Admin API libraries in 2021 and this new Node library is the first to be released. Our goal is to create a suite of open-source libraries consistent in functionality across a variety of languages and Shopify’s app best practices. We also have future plans to build enhanced experiences on shopify.dev based on these libraries (tutorials with code samples and requests in API references in your language preference).

We want your input to make the libraries as useful as possible, to enable the developer community to get their apps on the Shopify App Store as soon as possible.

Have some feedback? Reply to this post and let us know!

Liam | Developer Community Manager @ Shopify 
 - Was my reply helpful? Click Like to let me know! 
 - Was your question answered? Mark it as an Accepted Solution
 - To learn more visit Shopify.dev or the Shopify Web Design and Development Blog

dylanpierce
Shopify Partner
140 2 48

Finally we have official NextJs + Koa session token authentication support!

This is great and something I & the Node community has been asking for for quite some time.

https://github.com/Shopify/shopify-app-bridge/issues/13

However, I just want to point out that since NextJs version 10, they no longer recommend using a separate secondary server (like Koa.js) to handle backend API requests. Instead they have included API routing support directly in the framework: https://nextjs.org/docs/api-routes/introduction

I
n addition you cannot deploy a NextJS application to Vercel with the official Shopify NextJS + Koa implementation. https://nextjs.org/docs/advanced-features/custom-server

CleanShot 2021-02-26 at 09.19.46.png

In addition after rolling out my own 100% NextJS implementation of OAuth & Session Token validation on my projects, I'm seeing a huge reduction in page refresh time. The development cycle is so much quicker.

I know NextJS and Javascript practices move much more quickly than mature frameworks like Ruby on Rails, I just ask that we try to be more in lockstep with the latest version & practices of the software stack in the documentation.

That's my only ask! Thanks again for sharing this with the community, most other NextJS apps are following the official docs and this will help most get their foot in the door.

Founder of Verdict - Anti-Fraud Apps for Shopify
  • Blockade - Easily block countries, IP addresses, VPNs
  • Real ID - Verify your customer's real IDs easily & securely
amosmos
Shopify Expert
64 1 23

Hey @dylanpierce share your custom framework or at least record a video tutorial about how you made it and sell it, I want to buy

 

Amos

dylanpierce
Shopify Partner
140 2 48

Thanks @amosmos it's just the authentication portion, no full fledged framework yet.

It's available to download as an npm/yarn package: https://github.com/ctrlaltdylan/shopify-nextjs-toolbox

```

npm i --save shopify-nextjs-toolbox

yarn add shopify-nextjs-toolbox

```

And here's an example app repository using the package for authentication with OAuth & the new session tokens without cookies: https://github.com/ctrlaltdylan/shopify-session-tokens-nextjs

All open source and free.

Founder of Verdict - Anti-Fraud Apps for Shopify
  • Blockade - Easily block countries, IP addresses, VPNs
  • Real ID - Verify your customer's real IDs easily & securely
mattryles
New Member
1 0 0

Thanks @dylanpierce , much appreciated by a new Shopify dev trying to use the correct auth flow. 

0 Likes
dylanpierce
Shopify Partner
140 2 48

@mattryles glad it's helping you!

Founder of Verdict - Anti-Fraud Apps for Shopify
  • Blockade - Easily block countries, IP addresses, VPNs
  • Real ID - Verify your customer's real IDs easily & securely
0 Likes
amosmos
Shopify Expert
64 1 23

Thanks @dylanpierce you're awesome!

For some reason in my original post the smilies I put didn't show, just know I meant it with tons of respect!

 

Thanks,

Amos

0 Likes
luistmartins
Tourist
6 0 1

@dylanpierce thank you so much for making this available. This has been super useful to me, to be able to get around the necessity of deploying to Vercel but also using queries to a MongoDB.

0 Likes
GoodfyLabs
Explorer
58 0 8

Hi there @Liam  a very novice questions ..

 

I am following tutorial but got confuse about Shopify.Context.Initialize ... 

can I still use even if my first app will be a PRIVATE ONE ?  The readme in the library mention the tutorial is also viable to PRIVATE ... but in Private I do not have a API_SECRET_KEY ( we have SHARED_SECRET ) ...

ANYBODY can help with this Newbie question ?

BR

William Alencar
GoodFy Labs
Brazilian Shopify Experts
Getting Satisfied Customers around the World
Skype : william.br1
luistmartins
Tourist
6 0 1

@GoodfyLabs independently from being a public or private app, you should get the API keys listed on the app main screen as shown here: https://cln.sh/vbENzd