Review connections (developers)
Manage your review connections through our API
Santeri
Last Update miesiąc temu
Third-party reviews can be imported into Trustmary via review connections. These review connections can be managed via our API.
Review connection object
Attributes:
- id string
Unique identifier for the object.
- slug string
- User specified short name for the object.
- title string
- The title of the review connection.
- source string
- Which third-party service is used in the connection.
- lang string
- Language of the reviews.
- targetId string
- Unique identifier of target.
- targetUrl string
- URL of target.
Example
Listing review connections
Returning
Updating review connections
The review connection ID (as returned by POST or GET) can be used to access a review connection.
The following properties can be changed for a review connection:
- slug
- title
If not set in the POST body, the property will not be changed. E.g., to change just the slug the request body should look like this:
Adding new review connections
Review connections can be added by using a review source page URL or using explicit review service ID.
The URL is the same URL as you would use to browse the reviews on the external review service.
The title and the slug can be set when adding a connection. E.g. to add a new connection by URL, the request body shoud look like this:
Alternatively, for some services it is required to use an ID or it might be more convenient in case you are already handling review page ID's. When using an ID, the source type must be known. The following request body is an example on how to add a Capterra source by ID.
An optional lang parameter might be needed for some services.
The response body will contain the system set ID for the added connection.
Removing review connections