Shopify GraphQL and Restful Admin API client
Shopify GraphQL Admin API Docs
import "github.com/caiguanhao/shopify"
src := shopify.Oauth2StaticTokenSource(
&shopify.Oauth2Token{AccessToken: os.Getenv("SHOPIFY_TOKEN")},
)
httpClient := shopify.Oauth2NewClient(context.Background(), src)
client := shopify.NewClient(os.Getenv("SHOPIFY_SHOP"), httpClient)var customers []struct {
Id string `json:"id"`
Email string `json:"email"`
}
client.New(`query { customers(first: 10) { edges { node { id email } } } }`).
MustDo(&customers, "customers.edges.*.node")var cursor *string
var hasNextPage bool = true
for hasNextPage {
client.New(`query ($n: Int, $after: String) {
customers(first: $n, after: $after) {
pageInfo { hasNextPage }
edges { cursor node { id email } } } }`, "n", 2, "after", cursor).
MustDo(
&customers, "customers.edges.*.node",
&cursor, "customers.edges.*.cursor",
&hasNextPage, "customers.pageInfo.hasNextPage",
)
}// get themes
var themes []struct {
Id int
Role string
}
client.NewRest("GET", "themes").MustDo(&themes, "themes.*")
// get files of a specific theme
var files []string
client.NewRest("GET", fmt.Sprintf("themes/%d/assets", 100000000000), shopify.KV{
"fields": "key",
}).MustDo(&files, "assets.*.key")
// update theme file
var updatedAt string
client.NewRest("PUT", fmt.Sprintf("themes/%d/assets", 100000000000), nil, shopify.KV{
"asset": shopify.KV{
"key": "layout/theme.liquid",
"value": "<html>...</html>",
},
}).MustDo(&updatedAt, "asset.updated_at")You can use NewMulti():
var url, code string
gql, args, targets := shopify.NewMulti("query").
Add("currentAppInstallation").Return(`{ launchUrl }`).
Out(&url, ".launchUrl").Self().
Add("shop").Return("{ currencyCode }").
Out(&code, ".currencyCode").Self().
Do()
client.New(gql, args...).MustDo(targets...)
fmt.Println(url, code)Or write your own GQL:
var launchUrl, currencyCode string
client.New("{ cai: currentAppInstallation { launchUrl }, shop: shop { currencyCode } }").
MustDo(&launchUrl, "cai.launchUrl", ¤cyCode, "shop.currencyCode")
fmt.Println(launchUrl, currencyCode)Create a new App and put http://127.0.0.1/hello to "Allowed redirection URL(s)".
Copy the API key as ClientID, API secret key as ClientSecret.
conf := &shopify.Oauth2Config{
ClientID: "f75xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
ClientSecret: "shpss_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
Scopes: []string{
"read_customers",
// for list of access scopes, visit:
// https://shopify.dev/api/usage/access-scopes
},
RedirectURL: "http://127.0.0.1/hello",
Endpoint: shopify.Oauth2Endpoint{
AuthURL: "https://<YOUR-SHOP-NAME>.myshopify.com/admin/oauth/authorize",
TokenURL: "https://<YOUR-SHOP-NAME>.myshopify.com/admin/oauth/access_token",
},
}
// redirect user to consent page to ask for permission
fmt.Println(conf.AuthCodeURL("state"))
// once user installed the app, it will redirect to url like this:
// http://127.0.0.1/hello?code=codexxxxxxxxxxxxxxxxxxxxxxxxxxxx&hmac=...
// verify the request then get the token with the code in the url
token, err := conf.Exchange(ctx, "codexxxxxxxxxxxxxxxxxxxxxxxxxxxx")
if err != nil {
log.Fatal(err)
}
// save the token as json for later use
json.Marshal(token)
// load the token
ctx := context.Background()
token := new(shopify.Oauth2Token)
json.Unmarshal(/* token content */, token)
src := conf.TokenSource(ctx, token)
httpClient := shopify.Oauth2NewClient(ctx, src)
client := shopify.NewClient(/* your shop name */, httpClient)export SHOPIFY_TOKEN=shpat_00000000000000000000000000000000 SHOPIFY_SHOP=demo
export DEBUG=1 # if you want to show more info
go test -v ./...