Note: This is a technical explanation of the review request. For non technical explanation click here.

What does it do?

The review request API gives you the opportunity to generate a link to the review form on Springest. By sending additional information as JSON the review form will be pre-filled. The user landing on the page then only has to submit the review to Springest. 

JSON API information 

Information
POST URL	http://api.springest.nl/reviews/requests.json?api_key=***	URL to call review request api
Headers	{}	Header information
format	JSON	Information should be shared in JSON format
body	{}	The body contains the information needed to request information

Body information (POST)

Responses

When you POST your data to our API we run some validations on our end and will only process the request when they pass. When they don't, we let you know. As such, there are a couple of possible responses:

1. 201 Created 

2. When the review request has been created succesfully. It will return the training_id and the URL to the review form on Springest.
3. 400 Bad Request

4. This will trigger when validation fails. The response will be JSON or XML (based on the url you are POSTing to) that looks like this. Most errors contain either absence of one of the mandatory fields or the training_id/External_ID is not currently a published training in the Springest database.