Add validation only route for schemas

[snowplow]

Add validation only route for schemas

[alexanderdean]

Just be careful not to assume JSON Schema - remember Iglu will be used for other formats too.

Maybe something like:

/api/schemas/validate/jsonschema/instance=

[BenFradet]

Very true.

[BenFradet]

This is done, except for the naming of the query param, but I will do a complete overhaul of the names of the query params soon.

[alexanderdean]

Nice one. I wanted to ask about the query params. For a POST (i.e. new resource) in a RESTful world, is it best practice to use a query param for the thing you are posting, or is it better just to make the new resource the post body? What do e.g. Zendesk or Stripe do?

[BenFradet]

Mostly through the request's body, but for our post requests, both are supported.

[alexanderdean]

Yes - I guess the advantage of going through the request's body is that you don't need to come up with a parameter name for the thing being posted, which would vary with the type of resource...

[BenFradet]

I had a look at the stripe's api (eg https://stripe.com/docs/api#create_refund) and they mostly go through form-like parameters. I think supporting both might still be the way to go.

[alexanderdean]

Okay cool

[BenFradet]

Done in r2, closing.