Jos haluatte näyttää SaysScorenne ja arvostelunne omalla ulkoasullanne tai omassa järjestelmässänne, voitte hakea ne API:lla. Se on REST ja JSON, eivätkä nämä kutsut vaadi avainta.
Pisteet ja jakauma
GET https://api.trustsays.com/v1/companies/yrityksenne.fi
Vastaus sisältää muun muassa:
- saysScore: SaysScorenne.
- reviewCount: arvostelujen määrä.
- distribution: 1–5 tähden arvostelujen määrät.
Arvostelut
GET https://api.trustsays.com/v1/companies/yrityksenne.fi/reviews
Vastaus tulee sivuina, joilla on 10 arvostelua. Valitkaa sivu parametrilla page. Vastaus kertoo myös kokonaismäärän ja sivujen määrän. Voitte suodattaa parametreilla:
- stars: esim. 4,5, jolloin vain 4 ja 5 tähteä.
- lang: arvostelun kieli, esim. fi.
- country: maa, esim. FI.
- verified=true: vain vahvistetut ostokset.
- replied=true: vain arvostelut, joihin on vastattu.
- sort: newest, helpful, rating_desc tai rating_asc.
Hyvä tietää
- Kutsukaa API:a palvelimeltanne. Sitä ei voi kutsua suoraan selaimesta toisella verkkotunnuksella.
- Vastaukset tallennetaan välimuistiin enintään 60 sekunniksi, joten uusien arvostelujen näkyminen voi kestää minuutin. Älkää hakeko useammin kuin on tarpeen.
- SDK:ita tai julkista dokumentaatiota ei vielä ole. Katsokaa esimerkkejä sivulta API ja kehittäjät.
- Vastaukset omasta asiakaspalvelutyökalustanne ja aiheet API:n kautta tulevat myöhemmin.
Jos se ei toimi
- 404: Verkkotunnusta ei löydy TrustSaysista. Käyttäkää verkkotunnusta ilman https:ää ja www:tä.
- Jos haluatte vain näyttää tähdet, widget on helpompi. Katsokaa Lisää tähdet verkkosivuille.
Oliko tästä apua?
Tarvitsetko vielä apua?Kirjoita meille, niin palaamme asiaan. Vastaamme arkisin klo 8–18.Ota yhteyttä