Blog Posts¶
Manage blog posts on your Ning Network
Properties¶
- id (id) [Read only]
- The unique ID for a blog post
- author (screenname) [Read only]
- The screen name of the member who created the blog post
- createdDate (date) [Read only]
- The time stamp from the creation date
- publishTime (date) [Read/Write]
- The time stamp for when to publish the blog post, can be a time in the future or the past. If you want to use the current time, use the value now.
- publishStatus (string) [Read/Write]
- The status of the blog post, can be either draft, queued, or publish
- updatedDate (date) [Read only]
- The time stamp from the last modification
- featuredDate (date) [Read only]
- When the blog post was featured
- title (string) [Read/Write]
- The title of the blog post
- description (string) [Read/Write]
- The content of the blog post
- visibility (visibility) [Read/Write]
- Can friends see or all members see the blog post
- approved (boolean) [Read/Write]
- True if the administrator has approved the blog post
- commentCount (int) [Read only]
- The number of comments on the blog post
- url (url) [Read only]
- URL of the blog post
- topTags (string) [Read only]
- A array of the most popular tags: [ "food", "apple" ]
- tag (string) [Write only]
- Used during create and update requests to set tags on the blog post. Reading from this field is depreciated, instead use the topTags attribute.
Sub-Properties¶
HTTP GET¶
/xn/rest/apiexample/1.0/BlogPost ¶
Retrieve a specific blog post or a specific set of blog posts, up to 100.
/xn/rest/apiexample/1.0/BlogPost/recent ¶
Retrieve blog posts sorted by createdDate
Optional Query Parameters:¶
- author (screenname)
- Retrieve blog posts for a specific user
- private (boolean)
- If true, only retrieve private blog posts. If you are not the Network Creator, using this parameter will result in a 403 Forbidden error.
- approved (boolean)
- If true, only retrieve approved blog posts
- tag (string)
- Only include blog posts with the specified tag
- fields (field)
- Comma-separated list of desired properties, this is only a hint to the server
- anchor (string)
- An opaque token encodes the page of results returned, used in conjunction with count to page through a result set
- count (int)
- Returns one blog post by default and supports a maximum of 100. Also supports negative values down to -100 for retrieving blog posts before the anchor.
/xn/rest/apiexample/1.0/BlogPost/featured ¶
Retrieve blog posts sorted by featuredDate
Optional Query Parameters:¶
- author (screenname)
- Retrieve blog posts for a specific user
- approved (boolean)
- If true, only retrieve approved blog posts
- fields (field)
- Comma-separated list of desired properties, this is only a hint to the server
- anchor (string)
- An opaque token encodes the page of results returned, used in conjunction with count to page through a result set
- count (int)
- Returns one blog post by default and supports a maximum of 100. Also supports negative values down to -100 for retrieving blog posts before the anchor.
/xn/rest/apiexample/1.0/BlogPost/count ¶
Retrieve the number of blog posts created after the given date
Required Query Parameters:¶
- createdAfter (date)
- The ISO-8601 date to start counting after. If the date is more than a week old, a 400 response will be returned
Optional Query Parameters:¶
- author (screenname)
- Retrieve the number of blog posts for a specific user
- private (boolean)
- If true, only retrieve the number of private blog posts. If you are not the Network Creator, using this parameter will result in a 403 Forbidden error.
- approved (boolean)
- If true, only retrieve the number of approved blog posts
- tag (string)
- Only count blog posts with the specified tag