Get a blog article
Fetches a single article. An article addressed through a blog it does not belong to is a 404 (code blog_article_not_found).
Supported on Shopify (platform shopify). Accounts on platforms
without blogs support return 400; a blogs-capable platform that lacks
this specific operation returns 405.
Authorization
bearerAuth API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.
In: header
Path Parameters
Connected Shopify SocialAccount id.
Platform-native numeric blog id. Non-numeric values return 400.
^\d+$Platform-native numeric article id. Non-numeric values return 400.
^\d+$Response Body
application/json
application/json
application/json
{ "platform": "shopify", "article": { "id": "string", "blogId": "string", "platform": "shopify", "title": "string", "bodyHtml": "string", "handle": "string", "tags": [ "string" ], "author": "string", "excerpt": "string", "image": { "url": "string", "altText": "string" }, "isPublished": true, "publishedAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}Create a blog article
Creates an article on the blog. Publishing behavior: - `isPublished: false` keeps the article as a draft. - A future `publishDate` schedules publication natively on the platform; the platform publishes it at that time with no Zernio queue involved. - `seo.title` / `seo.description` map to Shopify's global `title_tag` and `description_tag` metafields (the fields Shopify themes read for the page title and meta description). Supported on Shopify (platform `shopify`). Accounts on platforms without blogs support return 400; a blogs-capable platform that lacks this specific operation returns 405.
Update a blog article
Partial-updates an article. Send any subset of the create fields (`title`, `bodyHtml`, `handle`, `tags`, `author`, `excerpt`, `image`, `seo`, `isPublished`, `publishDate`); at least one field is required (an empty body returns 400). `isPublished` and `publishDate` behave as on create: `isPublished: false` unpublishes back to a draft and a future `publishDate` schedules publication natively on the platform. Supported on Shopify (platform `shopify`). Accounts on platforms without blogs support return 400; a blogs-capable platform that lacks this specific operation returns 405.