JSON schemas for Webhooks and API

andrew2019
Tourist
3 0 3
Hello,

 

We are integrating with Shopify using webhooks and API. We want to validate the data we receive and don't want to guess creating our own JSON schemas. Do you know a place or a way for getting JSON schemas we can trust for below data sources?

 

Webhooks:
1. orders/create
2. customers/create

 

API methods:
1. GET /admin/api/#{api_version}/checkouts.json - Retrieves abandoned checkouts
2. GET /admin/api/#{api_version}//products.json - Retrieves a list of products.

 

0 Likes
Alex
Shopify Staff
Shopify Staff
1555 81 294

The corresponding resources as they are serialized in the admin should mirror exactly what's sent in the webhooks. Inspecting a customer resource, for example, should effectively blueprint what a payload will look like.

 

Alternatively, you could create a test webhook (or a real one) on a development store, and trigger that webhook to fire at your app, and use that to build out an expectation of the shape of the request.

 

From there, keep your eyes on the change log. If we ship anything that could change the expected shape of these resources, we intend to let you know what to expect.

 

Cheers.

0 Likes
andrew2019
Tourist
3 0 3

This is something I called guessing, but thank you for the response.

marbuthnott
New Member
1 0 0

Hi,

 

Just checking in to confirm that you guys don't have a schema for Shopify webhooks?

 

Specifically looking at 'orders/fulfilled' and 'customers/create'.

 

Many thanks,

Magnus

0 Likes
ctownsend
New Member
1 0 1

This would be very useful, especially when using languages that are strongly typed. Is it possible to request this feature?

 

Json Schemas for all endpoints

grant14
New Member
1 0 1

Yep +1

sheldonfrith
New Member
2 0 0

This is definitely needed. "should match" is not good enough.

0 Likes