L’integrazione tramite flusso può essere eseguita in 2 modi:
- Chiamata del flusso sui nostri server;
- Lettura del flusso da parte dei tuoi server (deposito giornaliero del flusso dei prodotti).
In caso di chiamata da parte dei nostri server, la chiamata deve essere effettuata con i seguenti parametri:
{{site}}: l’ID Website del tuo account Recensioni Verificate (obbligatorio);
{{site-1}}: corrisponde al primo carattere dell’ID Webiste del tuo account Recensioni Verificate;
{{site-2}}: corrisponde al secondo carattere dell’ID Website del tuo account Recensioni Verificate;
{{site-3}}: corrisponde al terzo carattere dell’ID Website del tuo account Recensioni Verificate;
{{productID}}: l’ID del prodotto della pagina corrente.
URL:
https://cl.avis-verifies.com/medias/components/html/json/{{site-1}}/{{site-2}}/{{site3}}/{{site}}/{{product}}.json Exemple : https://cl.avis-verifies.com/medias/components/html/json/5/9/8/598b6360-e762-cf54-790a85cfdcb0bdc1/TEST.json
Fare una domanda
La domanda viene inviata chiamando un iframe contenente un URL con dei parametri.
Tre parametri sono obbligatori per riuscire a chiamare l’iframe. Gli altri consentono ad esempio la precompilazione dei campi utente.
{{idWebsite}}: l’ID Website del tuo account Recensioni Verificate (obbligatorio);
{{token}}: corrisponde a un hash (sha1) del tuo ID Website e della tua chiave segreta (obbligatorio);
{{productId}}: l’ID del prodotto della pagina corrente (obbligatorio);
{{firstName}}: permette di precompilare il campo “Nome” se un utente è connesso;
{{lastName}}: permette di precompilare il campo “Cognome” se un utente è connesso;
{{email}}: permette di precompilare il campo “Email” se un utente è connesso;
{{category}}: consente di assegnare una categoria a una domanda;
{{productPage}}: permette di salvare la scheda prodotto per renderla disponibile dal 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}}
Risposta pubblica
L’invio di una risposta pubblica viene eseguito chiamando un iframe contenente un URL con dei parametri.
Tre parametri sono obbligatori per riuscire a chiamare l’iframe. Gli altri consentono ad esempio la precompilazione dei campi utente.
{{idWebsite}}: l’ID Website del tuo account Recensioni Verificate (obbligatorio);
{{token}}: corrisponde a un hash (sha1) del tuo ID Website e della tua chiave segreta (obbligatorio);
{{uuid}}: UUID della domanda. E’ presente all’interno del flusso JSON (obbligatorio);
{{firstName}}: permette di precompilare il campo “Nome” se un utente è connesso.
{{lastName}}: permette di precompilare il campo “Cognome” se un utente è connesso;
{{email}}: permette di precompilare il campo “Email” se un utente è connesso. 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}}
Votare per una domanda/risposta
Il voto alle domande/risposte avviene tramite API.
{{idWebsite}}: l’ID Website del tuo account Recensioni Verificate (obbligatorio);
{{token}}: corrisponde a un hash (sha1) del tuo ID Website e della tua chiave segreta (obbligatorio);
{{query}}: azione che l'API deve effettuare. Il valore è: "voto" (obbligatorio)
{{uuid}}: UUID della domanda/risposta che l’utente vuole votare (obbligatorio)
{{type}}: voto positivo o negativo per la domanda/risposta. Può assumere solo il valore “up” o “down” (obbligatorio).
- Metodo POST
https://qr.netreviews.eu/apiForm.php
Parametri:
{{idWebsite}}: l’ID Website del tuo account Recensioni Verificate (obbligatorio);
{{token}}: corrisponde a un hash (sha1) del tuo ID Website e della tua chiave segreta (obbligatorio);
{{query}}: azione che l'API deve effettuare. Il valore è: "voto" (obbligatorio);
{{uuid}}: UUID della domanda/risposta votata dall’utente (obbligatorio);
{{type}}: voto positivo o negativo per la domanda/risposta. Può assumere solo il valore “up” o “down” (obbligatorio).
- Metodo GET
https://qr.netreviews.eu/apiForm.php?
idWebsite={{idWebsite}}&token={{token}} &query={{query}}&uuid={{uuid}}&type={{type}}
Messaggio di ritorno:
{success: true, code: "0X0000000", message: "success"}
{success: false, code: "0X000000?", message: "{{ERROR MESSAGE}}"}
{success: true, code: "0X0000000", message: "already_voted"}
Il codice di errore varia a seconda del tipo di errore. Ad esempio, in caso di un errore di parametro il codice sarà “0X0000003”. {{ERROR MESSAGE}} dipende anche dal tipo di errore, per lo stesso esempio il messaggio sarà “INVALID PARAMETERS”.
Un utente può votare una domanda/risposta una sola volta e per questo motivo il messaggio “already_voted” può essere restituito dall’API, indicando che il voto era già stato preso in considerazione.
Segnalare un elemento
L’invio di una segnalazione viene eseguito chiamando un iframe contenente un URL con dei parametri. Tre parametri sono obbligatori per chiamare correttamente l’iframe. Gli altri, ad esempio, consentono la precompilazione dei campi utente. Non è possibile segnalare le risposte inviate da un moderatore.
{{idWebsite}}: l’ID Website del tuo account Recensioni Verificate (obbligatorio);
{{token}}: corrisponde a un hash (sha1) del tuo ID Website e della tua chiave segreta (obbligatorio);
{{uuid}}: UUID dell’elemento che si vuole segnalare. E’ presente all’interno del flusso JSON (obbligatorio);
{{firstName}}: permette di precompilare il campo “Nome” se un utente è connesso;
{{lastName}}: permette di precompilare il campo "Cognome” se un utente è connesso;
{{email}}: permette di precompilare il campo “Email” se un utente è connesso. URL: //cl.avisverifies.com/medias/components/html/form/report/{{idWebsite}}_report.html#/?&idWebsite={ {idWebsite}}&token={{token}}&uuid={{uuid}}&firstname={{firstName}}&lastname={{lastName}}& email={{email}}