November 18th, 2011 Changelog

New features

• New Tag endpoint

  • Allows developers to access all the tags attached to a content item.

• New Friend endpoint

  • Get the list of your friends
  • Get the list of friends for another member
  • Add a friend
  • Remove a friend

• Blog Post endpoint

  • Add tags on creation
  • Update tags
  • Filter by tag
  • Renamed the tags field to topTags

• Photo endpoint

  • Add tags on creation
  • Update tags
  • Filter by tag
  • Renamed the tags field to topTags

• Activity endpoint

  • Include CreateTopic event in results
  • Include CreateTopicComment event in results

Details

We chose to rename the tags field to topTags because that’s what it contains. Calling the field tags was misleading because one would expect to see all tags associated with a content item.

To access all tags attached to a content item, developers needed a way to paginate through long lists. This is why we ended up with a new tag endpoint.

Examples

Get twenty tags from a blog post:

GET /xn/rest/apiexample/1.0/Tag/list?attachedTo=12344:BlogPost:12314&count=20

Get the list of your friends:

GET /xn/rest/apiexample/1.0/Friend/recent?fields=friend,state&count=10

Get the list of friends for another member:

GET /xn/rest/apiexample/1.0/Friend/recent?author=3ixs6bzjxfkz6&fields=friend,state

Add a friend:

POST /xn/rest/apiexample/1.0/Friend?friend=3ixs6bzjxfkz6

Remove a friend:

DELETE /xn/rest/apiexample/1.0/Friend?friend=3ixs6bzjxfkz6

Add tags on blog post creation:

POST /xn/rest/apiexample/1.0/BlogPost

title=Hello+tags
description=Tags+are+fun
tag=cat
tag=dogs
tag=multi+word

Update tags on a photo:

PUT /xn/rest/apiexample/1.0/Photo?id=1234:Photo:3234

tag=cat
tag=dogs
tag=multi+word

Get three recent blog posts tagged cats:

GET /xn/rest/apiexample/1.0/BlogPost/recent?tag=cats&fields=title,description&count=3