The following document describes changes made to the rest API between Telligent Evolution 5.6 and Telligent Evolution 6.0.

In this Article

Changes

  • Support for URLs that used /{format} rather than .{format} was removed. We previously deprecated support for using /{format} several releases of REST ago in favor of using .{format} because that is a more standard approach. In this release, we are removing the functionality.
  • Deprecation of  the Title property for forums, wikis, galleries, blogs in favor of Name. It will work until the next release. We changed from Title to Name to standardize across the section/post types; it better matches the existing and internal usage and what people might expect.
  • Change of Namespace from "CommunityServer..." to "Telligent.Evolution....". This will only affect making custom endpoints. In this release, we were able to make the namespace change across the entire product from CommunityServer.* to Telligent.Evolution.* to match the product name change done a few releases ago.
  • Updated the show group membership by userid so that the accessing user does not need group membership permission to view their membership for a group.
  • Removed restriction for Anonymous to access REST "on-site".
  • Updated Json.NET library to the .NET 4.0 release from Jan 2011.

Additions

  • Added Create, Update, and Delete endpoints for forums.
  • Added Create, Update, and Delete endpoints for wikis.
  • Added Create, Update, and Delete endpoints for groups.
  • Added Create, Update, and Delete endpoints for blogs.
  • Added Create, Update, and Delete endpoints for galleries.
  • Added Telligent.Evolution.Api.
  • Added support to all paged list endpoints so that if the requested page index is beyond the upper bounds then pageindex will be updated to the last valid page and those results will be returned.
  • Added List endpoint for Media:
    • /api.ashx/v2/media/{mediagalleryid}/files.xml - list media by gallery.
    • /api.ashx/v2/groups/{groupid}/media/files.xml - list media by group.
    • /api.ashx/v2/media/files.{format} - list of media, to be used with MediaGalleryIds to filter media by multiple media galleries.
  • Added List endpoint for blog posts:
    • /api.ashx/v2/blogs/{blogid}/posts.{format} - list of blog posts for a blog.
    • /api.ashx/v2/groups/{groupid}/blogs/posts.{format} - list of blog posts for a group.
    • /api.ashx/v2/blogs/posts.{format} - list of blog posts, to be used with BlogIds param so you can filter blog posts by multiple blog ids.
  • Added List, Show endpoints for Wiki Page Revisions:
    • /api.ashx/v2/wikis/{wikiid}/pages/{pageid}/revisions.{format} - list revisions for a wiki page.
    • /api.ashx/v2/wikis/{wikiid}/pages/{pagekey}/revisions.{format} - list revisions for a wiki page.
    • /api.ashx/v2/wikis/{wikiid}/pages/{pageid}/revisions/{revisionnumber}.{format} - show details for a wiki page revision.
    • /api.ashx/v2/wikis/{wikiid}/pages/{pagekey}/revisions/{revisionnumber}.{format} - show details for a wiki page revision.
  • Added AboutTitle property to Blog.
  • Added EmbedCode, Download count, View count, and ratings info to Media.
  • Added List endpoint for forum threads:
    • /api.ashx/v2/forums/threads.{format} - list forum threads sitewide.
    • /api.ashx/v2/forums/{forumid}/threads.{format} - list forum threads for a forum.
    • /api.ashx/v2/groups/{groupid}/forums/threads.{format} - list forum threads for a group.
  • Added optional property, DeleteApplications, to the group delete endpoint.
  • Added PostsToModerate property to Forum.
  • Added List blogs endpoint:
    • /api.ashx/v2/blogs.{format} - list blogs sitewide
    • /api.ashx/groups/{groupid}/blogs.{format} - list blogs for a group.
  • Added IsExternal and IsLocked to BlogPost.
  • Added (chameleon-based) logic for how to calculate BlogPost.Excerpt.
  • Added support for search facets and facet filters.
  • Added endpoint to display SiteSettings at /api.ashx/v2/info/sitesettings.xml.
  • Added endpoints to display Application configuration at:
    • /api.ashx/v2/info/blogconfiguration.xml
    • /api.ashx/v2/info/forumconfiguration.xml
    • /api.ashx/v2/info/wikiconfiguration.xml
    • /api.ashx/v2/info/galleryconfiguration.xml
    • /api.ashx/v2/info/mailgatewayconfiguration.xml
    • /api.ashx/v2/info/adconfiguration.xml
    • /api.ashx/v2/info/spamconfiguration.xml
    • /api.ashx/v2/info/searchconfiguration.xml
    • /api.ashx/v2/info/solrconfiguration.xml
  • Added endpoints for deleting:
    • Activity messages
    • Status messages
    • Replies to status messages
  • Added ability to include joinless groups in list of groups. Do so by using grouptypes=Joinless (will show only Joinless). Use grouptypes=all to include all grouptypes.
  • Added IsLocked and SubscribeToThread properties to ForumThread and ForumReplies and allow setting/updating them when creating and updating a ForumThread and ForumReply.
  • Added Authors property to Blog.
  • Added BlogComment Show endpoint.
  • Added HasPoll, PollTitle, PollDescription and PollExpirationDate properties to ForumThread. Can set those when creating and updating a thread. Added endpoints for list, create, update, delete poll items.
  • Added new search content type: forumreply. The existing content type forum is now just forum threads.

Bug fixes

  • Added support for _ parameter (underscore) for all requests specifically because the JQuery ajax method uses that when cache is set to false.
  • Set a default value to forum replies when creating a reply via REST.