På den här sidan
Vill ni visa er SaysScore och era omdömen i er egen design eller ert eget system kan ni hämta dem med API:et. Det är REST och JSON, och de här anropen kräver ingen nyckel.
Betyg och fördelning
GET https://api.trustsays.com/v1/companies/erforetag.se
Svaret innehåller bland annat:
- saysScore: er SaysScore.
- reviewCount: antal omdömen.
- distribution: antal omdömen med 1 till 5 stjärnor.
Omdömen
GET https://api.trustsays.com/v1/companies/erforetag.se/reviews
Svaret kommer i sidor med 10 omdömen. Välj sida med page. Svaret anger också det totala antalet och antalet sidor. Ni kan filtrera med:
- stars: t.ex. 4,5 för bara 4 och 5 stjärnor.
- lang: omdömets språk, t.ex. sv.
- country: landet, t.ex. SE.
- verified=true: bara verifierade köp.
- replied=true: bara omdömen med svar.
- sort: newest, helpful, rating_desc eller rating_asc.
Bra att veta
- Anropa API:et från er server. Det kan inte anropas direkt från en webbläsare på en annan domän.
- Svaren sparas i upp till 60 sekunder, så nya omdömen kan ta en minut att dyka upp. Hämta inte oftare än nödvändigt.
- Det finns ännu inga SDK:er och ingen offentlig dokumentation. Se exempel på API och utvecklare.
- Svar från ert eget kundtjänstverktyg och ämnen via API kommer senare.
Om det inte fungerar
- 404: Domänen finns inte på TrustSays. Använd domänen utan https och www.
- Vill ni bara visa stjärnorna är en widget enklare. Se Sätt stjärnorna på webbplatsen.