Sapo Blog icon

Sapo Blog

Manage Sapo blogs and articles

Overview

This node, named "Sapo Blog," allows users to manage blogs and articles on the Sapo platform. It supports operations such as creating, retrieving, updating, and deleting blogs, articles, and comments. The node is particularly useful for automating content management workflows, such as publishing new blog posts, moderating comments, or fetching lists of comments for analysis.

A common scenario would be using this node to fetch all comments from a specific blog article to perform sentiment analysis or to moderate spam comments automatically. Another example is creating new blog posts or articles programmatically based on external data sources.

Properties

Name Meaning
ID Blog The unique numeric identifier of the blog.
Trả Về Tất Cả Boolean option to return all results or limit the number of returned items (applies to listing).
Giới Hạn Maximum number of results to return when not returning all (minimum 1).
Thông Tin Bổ Sung Additional optional filters and fields to refine queries, including:
- Published Status: Any, Published, Unpublished
- Handle: Filter by URL slug
- Created After: Filter by creation date minimum
- Created Before: Filter by creation date maximum
- Author: Filter by author name

These properties are used to specify which blog or article to operate on, what operation to perform, and how to filter or limit the data returned.

Output

The node outputs an array of JSON objects representing the result of the requested operation. The structure of the json output depends on the operation:

  • For retrieval operations (get, getMany, getComments), it returns the corresponding blog, article, or comment data as JSON.
  • For creation or update operations, it returns the newly created or updated resource's details.
  • For deletion operations, it returns a simple success confirmation object { success: true }.
  • In case of errors (if "Continue On Fail" is enabled), it returns an object with an error field containing the error message.

The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the Sapo platform.
  • Depends on the internal SapoApiBase class to interact with the Sapo API endpoints.
  • No additional environment variables are explicitly required beyond the API authentication setup.

Troubleshooting

  • Common Issues:

    • Invalid or missing blog/article/comment IDs will cause API errors.
    • Exceeding rate limits or incorrect API credentials will result in authentication errors.
    • Providing invalid JSON in the data property for create/update operations may cause request failures.
  • Error Messages:

    • Errors thrown by the node include the API error message and stack trace.
    • If "Continue On Fail" is disabled, the node execution stops on the first error.
    • To handle partial failures gracefully, enable "Continue On Fail" to receive error details in the output.
  • Resolution Tips:

    • Verify that all required IDs and parameters are correctly set.
    • Ensure the API key credential is valid and has necessary permissions.
    • Validate JSON input before passing it to the node.
    • Use the "Additional Fields" filters carefully to avoid unsupported query parameters.

Links and References


If you need details about other resources or operations, feel free to ask!

Discussion