Integration via feed can be done in two ways:
- Calling the feed from our servers
- Reading the feed from your servers (product feed sent daily)
In the case of a call from our servers, the call must be made with the following parameters:
{{site}}: the website identifier associated with your Verified Reviews account
{{site-1}}: the first character of the website identifier associated with your Verified Reviews account
{{site-2}}: the second character of the website identifier associated with your Verified Reviews account
{{site-3}}: the third character of the website identifier associated with your Verified Reviews account
{{product}}: your product’s identifier
URL:
https://cl.avis-verifies.com/medias/components/html/json/{{site-1}}/{{site-2}}/{{site3}}/{{site}}/{{product}}.json Example: https://cl.avis-verifies.com/medias/components/html/json/5/9/8/598b6360-e762-cf54-790a85cfdcb0bdc1/TEST.json
Asking a question
Questions are submitted by calling an iFrame containing a URL with parameters.
Three parameters are required in order for the iFrame call to be successful. The other parameters are there to pre-populate user fields, for example.
{{idWebsite}}: Your Verified Reviews user ID (required)
{{token}}: a sha1 hash of your website identifier and your secret key (required)
{{productId}}: the identifier of the current page’s product (required).
{{firstName}}: enables pre-population of the first name field if a user is signed in
{{lastName}}: enables pre-population of the last name field if a user is signed in
{{email}}: enables pre-population of the email address field if a user is signed in
{{category}}: enables you to assign the question to a category
{{productPage}}: enables you to save the product page so that it is available through the back office
URL:
//cl.avisverifies.com/medias/components/html/form/question/{{idWebsite}}_question.html&idWebsite= {{idWebsite}}&token={{token}}&productId={{productId}}&firstname={{firstName}}&lastname={{la stName}}&email={{email}}&category={{category }}&productPage={{productPage}}
Public answers
Public answers are submitted by calling an iFrame containing a URL with parameters.
Three parameters are required in order for the iFrame call to be successful. The other parameters are there to pre-populate user fields, for example.
{{idWebsite}}: your Verified Reviews user ID (required)
{{token}}: a sha1 hash of your website identifier and your secret key (required).
{{uuid}}: the question’s UUID. It is found in the JSON feed (required).
{{firstName}}: enables pre-population of the first name field if a user is signed in.
{{lastName}}: enables pre-population of the last name field if a user is signed in.
{{email}}: enables pre-population of the email address field if a user is signed in.
URL:
//cl.avisverifies.com/medias/components/html/form/answer/{{idWebsite}}_answer_public.html#/?&id Website={{idWebsite}}&token={{token}}&uuid={{uuid}}&firstname={{firstName}}&lastname={{lastName}}&email={{email}}
Voting for a question/answer
Voting for questions/answers is done via the API.
{{idWebsite}}: your Verified Reviews user ID (required)
{{token}}: a sha1 hash of your website identifier and your secret key (required)
{{query}}: action the API must perform; here this parameter’s value is “vote” (required)
{{uuid}}: UUID of the question/answer for which the user is voting (required)
{{type}}: positive or negative vote for the question/answer. The value can only be “up” or “down” (required)
- POST method
https://qr.netreviews.eu/apiForm.php
Parameters:
{{idWebsite}}: your Verified Reviews user ID (required)
{{token}}: a sha1 hash of your website identifier and your secret key (required)
{{query}}: action the API must perform; here this parameter’s value is “vote” (required)
{{uuid}}: UUID of the question/answer for which the user is voting (required)
{{type}}: positive or negative vote for the question/answer. The value can only be “up” or “down” (required)
- GET method
https://qr.netreviews.eu/apiForm.php?
idWebsite={{idWebsite}}&token={{token}} &query={{query}}&uuid={{uuid}}&type={{type}}
Returns:
{success: true, code: "0X0000000", message: "success"}
{success: false, code: "0X000000?", message: "{{ERROR MESSAGE}}"}
{success: true, code: "0X0000000", message: "already_voted"}
The error code varies according to the type of error. For example, with a parameter error the code will be “0X0000003”. {{ERROR MESSAGE}} also depends on the error type. Using the same example, the message will be: “INVALID PARAMETERS”
A user can only vote once per question/answer, which is why the API may return the message “already_voted”, indicating that the vote has already been taken into account.
Reporting an item
Items are reported by calling an iFrame containing a URL with parameters. For the iFrame call to be successful, three parameters are required. The other parameters are there to pre-populate user fields, for example. It is not possible to report the moderator’s answers.
{{idWebsite}}: your Verified Reviews user ID (required).
{{token}}: a sha1 hash of your website identifier and your secret key (required).
{{uuid}}: UUID of the item being reported. It is found in the JSON feed (required).
{{firstName}}: enables pre-population of the first name field if a user is signed in.
{{lastName}}: enables pre-population of the last name field if a user is signed in.
{{email}}: enables pre-population of the email address field if a user is signed in.
URL:
//cl.avisverifies.com/medias/components/html/form/report/{{idWebsite}}_report.html#/?&idWebsite={ {idWebsite}}&token={{token}}&uuid={{uuid}}&firstname={{firstName}}&lastname={{lastName}}& email={{email}}