MenuClose
CONTENT MANAGEMENT SYSTEM ONLINE HELP
Reviews and Comments - API Reference
Reviews and Comments
A blog comment or product review uses the same engine. Each record may have a rating, as well as an optional comment, and is linked to an object and the person who posted it
End Point URL
https://api.cms-tool.net/webapps/api/comments
API Parameters and Filters
| Name | Description | Example | Optional | Data type |
| data | The JSON you would like to POST. This can be POST content also |
{
}
|
Yes | json object |
| id | Search a specific comment by it's id | id=123 | Yes | int |
|
mbr_id |
The member who has commented |
mbr_id=111 |
Yes | int |
|
msg_show |
Filter comments which are marked to show |
msg_show = "yes" |
Yes | string |
|
postedAfter |
Filter comments which were posted before the time provided. |
postedAfter="2021-01-01" |
Yes | string |
|
postedBefore |
Filter comments which were posted before the time provided. |
postedBefore="2021-12-31" |
Yes | string |
| re_info_id | Enquiry about a specific blog's comments | re_info_id=1231234 | Yes | int |
| re_pid | Enquiry about a specifc product's reviews | re_pid=102212 | Yes | int |
| re_eventid | Enquiry about a specific event's reviews | re_eventid=12312 | Yes | int |
Data Dictionary
| Key | Definition | Type | Format |
Usage Instructions and Examples
Create a new Comment
To create a new comment use POST method and do not provide any Comment Id.
For the comment to show up on your site include the page id (can be found from GET data). and set "msg_show": "Y"
Must include: mbr_id or msg_email.
For the review to show on your product page include the forum_pid as the product id of the product.
Example:
{
"msg_text": "Comment text",
"msg_email": "example@email.com",
"msg_title": "Comment title",
"page": 1234
}
Update an existing comment
You can also update an existing Comment. You must include id, mbr_id or msg_email. The rest of the parameters provided will be used to update the Comment.
Example:
{
"id": 12345,
"msg_text" : "The message has been updated" ...
}
Sample Object
{"msg_posted":"2021-12-17 16:50:19.340045",}
"forum_info_id":0,
"msg_title":"New test review",
"msg_group_id":0,
"mbr_id":123123,
"forum_pid":1111111,
"forum_reply_count":0,
"msg_notifyreplies":"N",
"msg_email":"test@testemail.co.nz",
"msg_re":0,
"msg_rating":4,
"id":123111,
"page":1111111,
"mbr_uid":123123,
"msg_show":"Y",
"msg_id":123111,
"cid":11111111
API End Points
Content
Blog pages are usually presented as a list udner a primary page. Individual blog pages do not appear on the menu, only in lists. The blog engine also powers FAQ and gallery type pages
EndPoint: https://api.cms-tool.net/webapps/api/blog
A website is made up of the primary navigational pages that create the primary menu, as well as hidden pages and member only pages. Pages can contain pages in a treelike structure, however, this excludes sub pages which are defined as blogs or products
EndPoint: https://api.cms-tool.net/webapps/api/page
Ecommerce
Categories are used to group products. Products can belong in up to 8 categories.
Categories can also form a tree, with Category parent ID = 0 being the parent level category.
The term group is synomous with category, so many elements are prefixed with the word group.
EndPoint: https://api.cms-tool.net/webapps/api/category
Each product line of an order can be discounted, so an order can have multiple discounts, but only one per product.
EndPoint: https://api.cms-tool.net/webapps/api/discount
The available payment methods at checkout. An order can only have 1 payment method, but the admin can change the payment method, and take part payments.
EndPoint: https://api.cms-tool.net/webapps/api/paymentop
A saleable item, or variant of a parent product.
EndPoint: https://api.cms-tool.net/webapps/api/product
Invoices, orders, baskets and quotes are all represented by this object, and differentiated by status.
EndPoint: https://api.cms-tool.net/webapps/api/basket
The courier or freight fee rules available for checkout. Each order can only have rule applied
EndPoint: https://api.cms-tool.net/webapps/api/shipping
Members
Bulk emails represent a newsletter that will be sent to a bulk audience via a mailing list. Alternatively, a bulk email is a sequence within a campaign.
EndPoint: https://api.cms-tool.net/webapps/api/bulkemail
A message is created for every contact us, enquiry form, or custom form.
EndPoint: https://api.cms-tool.net/webapps/api/message
Group members/customers, each member can belong to unlimited groups. Groups can contain groups
EndPoint: https://api.cms-tool.net/webapps/api/membergroups
System security levels. Default level is 100 for general users.
EndPoint: https://api.cms-tool.net/webapps/api/reference/memberlevel
Members or customers or users are the same thing. These are anyone who has purchased, enquired, or who has permission to login, or receive newsletters. This excludes administrative users.
EndPoint: https://api.cms-tool.net/webapps/api/member
A blog comment or product review uses the same engine. Each record may have a rating, as well as an optional comment, and is linked to an object and the person who posted it
EndPoint: https://api.cms-tool.net/webapps/api/comments
Other
Bookings are for appointments, seats, hire items, etc. Not for events.
EndPoint: https://api.cms-tool.net/webapps/api/booking
Use the Event Attendee endpoint to get your event attendee information on your site.
EndPoint: https://api.cms-tool.net/webapps/api/eventAttendee
Events have a start/end date and additional information, they might be bookable, or just for informational purposes
EndPoint: https://api.cms-tool.net/webapps/api/event
Reference
A list of countries, and some meta data
EndPoint: https://api.cms-tool.net/webapps/api/reference/countries
EndPoint: https://api.cms-tool.net/webapps/api/reference/currencies
EndPoint: https://api.cms-tool.net/webapps/api/reference/fx
Generic categories are those that relate to open source categorisations of products for SEO purposes
EndPoint: https://api.cms-tool.net/webapps/api/reference/categories
EndPoint: https://api.cms-tool.net/webapps/api/reference/postcodes