Además de una integración completa en iframe, es posible integrar mediante API y flujo JSON.
Esta integración requiere más esfuerzo de su parte porque la pregunta, la respuesta pública y los formularios de informe se hacen de su lado.
Los formularios de intercambio y respuesta de la comunidad son elaborados por el equipo de preguntas y respuestas.
La ventaja de este método de integración es un mayor control sobre la herramienta de preguntas y respuestas.
La API de preguntas y respuestas le permite cuatro funciones:
- Hacer una pregunta
- Dar una respuesta pública
- Informar una respuesta
- Votar por una pregunta o una respuesta
La respuesta de la comunidad se envía mediante un enlace en el correo electrónico que investiga a la comunidad. Los intercambios están sujetos a la misma restricción. La documentación de la API en línea está disponible aquí.
Todas las llamadas a la API deben realizarse en POST. Todas las devoluciones de API están en JSON.
Debe incluir en los formularios de creación de preguntas, respuesta pública e informe el siguiente texto: "J'accepte <a href="https://www.avis-verifies.com/index.php?page=mod_conditions_utilisation" target="_blank" style='font-weight: bold'>les Conditions Générales d'Utilisation</a> et <a href="https://www.avis-verifies.com/index.php?page=mod_regles_confidentialites" target="_blank" style='font-weight: bold'>la Politique de Confidentialité</a> de Avis Vérifiés."
Hacer una pregunta
{{idWebsite}}: su nombre de usuario de Opiniones verificadas (obligatorio)
{{productId}}: el identificador de producto de la página actual (obligatorio)
{{token}}: corresponde a un hash sha1 del identificador de su sitio web y su clave secreta (obligatorio)
{{query}}: acción a realizar por la API, aquí este parámetro es igual a: "addQuestion" (obligatorio)
{{firstName}}: nombre o apodo de la persona que hizo la pregunta (obligatorio)
{{lastName}}: nombre de la persona que hizo la pregunta
{{email}}: correo electrónico de la persona que hizo la pregunta (obligatorio)
{{category}}: le permite asignar una categoría a la pregunta
{{productPage}}: le permite guardar la hoja del producto para que esté disponible en BackOffice
{{title}}: título de la pregunta (obligatorio)
{{question}}: contenido de la pregunta (obligatorio)
{{gcuCheck}}: aceptación de nuestros términos y condiciones y políticas de privacidad. Valores aceptados: verdadero / falso (booleano) (obligatorio).
URL : //qr.netreviews.eu/apiForm.php
Devoluciones:
{success: true, code: "0X0000000", message: " OPERATION SUCCESSFUL YOU WILL RECEIVE A VALIDATION MAIL"}
{success: false, code: "0X000000?", message: "{{ERROR MESSAGE}}"}
El código de error varía según el tipo de error, por ejemplo, durante un error de parámetro, el código será "0X0000003". {{ERROR MESSAGE}} también depende del tipo de error, con el mismo ejemplo, el mensaje será: «INVALID PARAMETERS».
Si tiene éxito, el usuario recibirá un correo electrónico de validación para confirmar su correo electrónico. Este paso es obligatorio para que los artículos estén disponibles en el back office.
Aportar una respuesta pública
{{idWebsite}}: su nombre de usuario de Opiniones verificadas (obligatorio)
{{token}}: corresponde a un hash sha1 del identificador de su sitio web y su clave secreta (obligatorio)
{{query}}: acción a realizar por la API, aquí este parámetro es igual a: "addPublicAnswer" (obligatorio)
{{firstName}}: nombre o apodo de la persona que envió la respuesta (obligatorio)
{{lastName}}: nombre de la persona que envió la respuesta
{{email}}: correo electrónico de la persona que envió la respuesta (obligatorio)
{{uuid}}: uuid de la pregunta (obligatorio)
{{text}}: contenido de la respuesta (obligatorio)
{{gcuCheck}}: aceptación de nuestros términos y condiciones y políticas de privacidad. Valores aceptados: verdadero / falso (booleano) (obligatorio).
URL : //qr.netreviews.eu/apiForm.php
Devoluciones:
{success: true, code: "0X0000000", message: " OPERATION SUCCESSFUL YOU WILL RECEIVE A VALIDATION MAIL"}
{success: false, code: "0X000000?", message: "{{ERROR MESSAGE}}"}
El código de error varía según el tipo de error, por ejemplo, durante un error de parámetro, el código será "0X0000003". {{ERROR MESSAGE}} también depende del tipo de error, con el mismo ejemplo, el mensaje será: «INVALID PARAMETERS».
Si tiene éxito, el usuario recibirá un correo electrónico de validación para confirmar su correo electrónico. Este paso es obligatorio para que los artículos estén disponibles en el back office.
Reportar una respuesta
{{idWebsite}}: su nombre de usuario de Opiniones verificadas (obligatorio)
{{token}}: corresponde a un hash sha1 del identificador de su sitio web y su clave secreta (obligatorio)
{{query}}: acción a realizar por la API, aquí este parámetro es: "addReport" (obligatorio)
{{firstName}}: nombre o apodo de la persona que envió el informe (obligatorio)
{{lastName}}: nombre de la persona que hizo la denuncia
{{email}}: correo electrónico de la persona que envió el informe (obligatorio)
{{uuid}}: uuid del elemento para informar (obligatorio)
{{text}}: contenido de la respuesta (obligatorio)
{{gcuCheck}}: aceptación de nuestros términos y condiciones y políticas de privacidad. Valores aceptados: verdadero / falso (booleano) (obligatorio).
URL : //qr.netreviews.eu/apiForm.php
Devoluciones:
{success: true, code: "0X0000000", message: " OPERATION SUCCESSFUL YOU WILL RECEIVE A VALIDATION MAIL"}
{success: false, code: "0X000000?", message: "{{ERROR MESSAGE}}"}
El código de error varía según el tipo de error, por ejemplo, durante un error de parámetro, el código será "0X0000003". {{ERROR MESSAGE}} también depende del tipo de error, con el mismo ejemplo, el mensaje será: «INVALID PARAMETERS».
Si tiene éxito, el usuario recibirá un correo electrónico de validación para confirmar su correo electrónico. Este paso es obligatorio para que los artículos estén disponibles en el back office.
Vote por una pregunta / respuesta
{{idWebsite}}: su nombre de usuario de Opiniones verificadas (obligatorio)
{{token}}: corresponde a un hash sha1 del identificador de su sitio web y su clave secreta (obligatorio)
{{query}}: acción a realizar por la API, aquí este parámetro es igual a: "votar" (obligatorio)
{{uuid}}: uuid de la pregunta / respuesta por la que vota el usuario (obligatorio)
{{type}}: voto positivo o negativo para la pregunta / respuesta. Solo se puede tomar por valor "arriba" o "abajo" (obligatorio)
URL : //qr.netreviews.eu/apiForm.php
Devoluciones:
{success: true, code: "0X0000000", message: "success"}
{success: false, code: "0X000000?", message: "{{ERROR MESSAGE}}"}
{success: true, code: "0X0000000", message: "already_voted"}
El código de error varía según el tipo de error, por ejemplo, durante un error de parámetro, el código será "0X0000003". {{ERROR MESSAGE}} también depende del tipo de error, con el mismo ejemplo, el mensaje será: «INVALID PARAMETERS».
Un usuario solo puede votar una vez y solo una vez, por lo que la API puede devolver el mensaje "already_voted", indicando que el voto ya se ha tenido en cuenta.