Si queréis mostrar vuestro SaysScore y vuestras opiniones con vuestro propio diseño o en vuestro sistema, podéis obtenerlos con la API. Es REST y JSON, y estas llamadas no requieren clave.
Puntuación y distribución
GET https://api.trustsays.com/v1/companies/jeresfirma.dk
La respuesta incluye, entre otras cosas:
- saysScore: vuestro SaysScore.
- reviewCount: número de opiniones.
- distribution: número de opiniones de 1 a 5 estrellas.
Opiniones
GET https://api.trustsays.com/v1/companies/jeresfirma.dk/reviews
La respuesta llega en páginas de 10 opiniones. Elegid la página con page. La respuesta también indica el número total y el número de páginas. Podéis filtrar con:
- stars: por ejemplo 4,5 para ver solo las de 4 y 5 estrellas.
- lang: el idioma de la opinión, por ejemplo es.
- country: el país, por ejemplo ES.
- verified=true: solo compras verificadas.
- replied=true: solo opiniones con respuesta.
- sort: newest, helpful, rating_desc o rating_asc.
Lo que conviene saber
- Llamad a la API desde vuestro servidor. No se puede llamar directamente desde un navegador en otro dominio.
- Las respuestas se guardan en caché hasta 60 segundos, así que las opiniones nuevas pueden tardar un minuto en aparecer. No hagáis peticiones más a menudo de lo necesario.
- Todavía no hay SDK ni documentación pública. Consultad ejemplos en API y desarrolladores.
- Las respuestas desde vuestra propia herramienta de atención al cliente y los temas a través de la API llegarán más adelante.
Si no funciona
- 404: el dominio no existe en TrustSays. Usad el dominio sin https ni www.
- Si solo queréis mostrar las estrellas, un widget es más fácil. Consulta Poner las estrellas en vuestra web.
¿Te ha sido útil?
¿Sigues necesitando ayuda?Escríbenos y te responderemos. Respondemos los días laborables de 8 a 18 h.Contáctanos