Admin: Created page with "In addition to an online storefront, a Spiffy Store comes with a built-in blogging engine, allowing a store to have one or more blogs. Store owners are encouraged to use blog..."

2018-05-24T01:25:09Z

Created page with "In addition to an online storefront, a Spiffy Store comes with a built-in blogging engine, allowing a store to have one or more blogs. Store owners are encouraged to use blog..."

New page

In addition to an online storefront, a Spiffy Store comes with a built-in blogging engine, allowing a store to have one or more blogs.

Store owners are encouraged to use blogs to:

* Make announcements
* Talk about their products in more detail
* Show off their expertise
* Connect with their customers
* Boost their store's search engine rankings

Spiffy Stores blogs are like most other blogs in that they are a content management system for articles posted in reverse chronological order. An Atom feed is automatically generated for each blog, allowing for syndication. The search functionality built into every shop also searches the text in blog articles.

Blogs are meant to be used as a type of magazine or newsletter for the store, with content that changes over time. If your store needs a static page, such as an "About Us" page, we recommend that you use a Page instead.

== Blog Properties ==

{| class="reference"
!id
|<pre>{ "id" : 113 }</pre>
A unique numeric identifier for the blog.
|-
!title
|<pre>{ "title": "Latest News" }</pre>
The title of the blog.
|-
!handle
|<pre>{ "handle": "latest-news" }</pre>
A unique, human-friendly string for the blog, generated automatically from its title. In online store themes, the Liquid templating language refers to a blog by its handle.
|-
!body
|<pre>{ "body": "" }</pre>
Not currently used.
|-
!body_html
|<pre>{ "body_html": "" }</pre>
Not currently used.
|-
!created_at
|<pre>{ "created_at": "2008-07-15T20:00:00-04:00" }</pre>
The date and time (ISO 8601 format) when the blog was created.
|-
!updated_at
|<pre>{ "updated_at": "2008-07-16T20:00:00-04:00" }</pre>
The date and time (ISO 8601 format) when the blog was last updated.
|-
!published
|<pre>{ "published" : true }</pre>
Indicates whether the blog is published and visible to customers.
|}

== Endpoints ==

=== <code>GET /api/blogs.json</code> ===

Retrieve a list of all blogs.

==== Optional Parameters ====

{| class="reference"
!limit
|Number of results returned. The default is 30, with a maximum of 50 in a single request.
|-
!page
|The number of the page to return. The number of results per page is set by the <code>limit</code> parameter. If more results are required, then submit the request again, increasing the page number each time.
|-
!since_id
|Limit the results to only include objects which have an id greater than the given value.
|-
!title
|Limit the results to only include blogs with the given title.
|-
!handle
|Limit the results to only include blogs with the given handle.
|-
!published_status
|Limit the results to only include blogs with the given published status ('published' or 'unpublished').
|-
!created_at_min
|Return only the blogs created after the given date and time. Use the format "2014-12-31 12:00".
|-
!created_at_max
|Return only the blogs created before the given date and time. Use the format "2014-12-31 12:00".
|-
!updated_at_min
|Return only the blogs updated after the given date and time. Use the format "2014-12-31 12:00".
|-
!updated_at_max
|Return only the blogs updated before the given date and time. Use the format "2014-12-31 12:00".
|-
!fields
|A comma-separated list of fields to return in the response.
|}

==== Example Request and Response ====

<pre>
GET /api/blogs.json

HTTP/1.1 200 OK

{
"blogs": [
{
"id": 248,
"title": "Latest News",
"handle": "latest-news",
"body": "",
"body_html": "",
"created_at": "2009-11-21T01:42:15.664+11:00",
"updated_at": "2015-09-10T12:16:29.619+10:00",
"published": true
}, ...
]
}

Examples using filters

GET /api/blogs.json?fields=id,title

</pre>

=== <code>GET /api/blogs/count.json</code> ===

Return a count of the number of blogs.

==== Optional Parameters ====

{| class="reference"
!since_id
|Limit the results to only include objects which have an id greater than the given value.
|-
!title
|Limit the results to only include blogs with the given title.
|-
!handle
|Limit the results to only include blogs with the given handle.
|-
!published_status
|Limit the results to only include blogs with the given published status ('published' or 'unpublished').
|-
!created_at_min
|Return only the blogs created after the given date and time. Use the format "2014-12-31 12:00".
|-
!created_at_max
|Return only the blogs created before the given date and time. Use the format "2014-12-31 12:00".
|-
!updated_at_min
|Return only the blogs updated after the given date and time. Use the format "2014-12-31 12:00".
|-
!updated_at_max
|Return only the blogs updated before the given date and time. Use the format "2014-12-31 12:00".
|}

==== Example Request and Response ====

<pre>
GET /api/blogs/count.json

HTTP/1.1 200 OK

{
"count": 3
}

</pre>

=== <code>GET /api/blogs/BLOG_ID.json</code> ===

Retrieves a single blog by ID.

==== Optional Parameters ====

{| class="reference"
!fields
|A comma-separated list of fields to return in the response.
|}

==== Example Request and Response ====

<pre>
GET /api/blogs/248.json

HTTP/1.1 200 OK

{
"blog": {
"id": 248,
"title": "Latest News",
"handle": "latest-news",
"body": "",
"body_html": "",
"created_at": "2009-11-21T01:42:15.664+11:00",
"updated_at": "2015-09-10T12:16:29.619+10:00",
"published": true
}
}
</pre>

=== <code>GET /api/blogs/BLOG_ID/authors.json</code> ===

Retrieves all the authors that have contributed to the blog.

==== Example Request and Response ====

<pre>
GET /api/blogs/248/authors.json

HTTP/1.1 200 OK

{
"authors": [
"Bilbo Baggins",
"System Admin"
]
}
</pre>

=== <code>POST /api/blogs.json</code> ===

Add a blog to the store.

==== Example Request and Response ====

<pre>
POST /api/blogs.json

{
"blog": {
"title": "My Latest Product",
"published": true
}
}

HTTP/1.1 201 Created
</pre>

=== <code>PUT /api/blogs/BLOG_ID.json</code> ===

Updates a blog.

==== Example Request and Response ====

<pre>
PUT /api/blogs/248.json

{
"blog": {
"id": 248,
"published": false
}
}

HTTP/1.1 200 OK
</pre>

=== <code>DELETE /api/blogs/BLOG_ID.json</code> ===

Deletes a blog and all of its articles from the store.

==== Example Request and Response ====

<pre>
DELETE /api/blogs/248.json

HTTP/1.1 200 OK

{}
</pre>

== Further Reference ==

* [[An Introduction to the Spiffy Stores API]]
* [[Creating Private API Keys]]
* [[Using the API]]
* [[API Reference]]

API Blog - Revision history

Admin: Created page with "In addition to an online storefront, a Spiffy Store comes with a built-in blogging engine, allowing a store to have one or more blogs. Store owners are encouraged to use blog..."