Sapo Trường Tùy Chỉnh icon

Sapo Trường Tùy Chỉnh

Quản lý trường tùy chỉnh trên Sapo

Actions72

Blog → Lấy Danh Sách

AI-generated

Overview

This node manages custom metafields on various resources within the Sapo platform, specifically supporting operations such as creating, retrieving, updating, deleting, counting, and validating metafields. For the Blog resource with the operation Lấy Danh Sách (Get Many), it fetches a list of metafields associated with a specific blog identified by its resource ID.

Common scenarios include:

  • Retrieving all or a limited number of custom fields attached to a blog for display or processing.
  • Filtering metafields by namespace, key, or creation date range to narrow down results.
  • Integrating with other workflows that require metadata about blogs stored in Sapo.

Practical example:

  • A user wants to get all custom metafields related to a particular blog post to synchronize them with another system or to analyze metadata usage patterns.

Properties

Name Meaning
ID Tài Nguyên The numeric identifier of the blog resource whose metafields are being queried.
Trả Về Tất Cả Boolean flag indicating whether to return all metafields or limit the number of results returned.
Giới Hạn Maximum number of metafield results to return when not returning all. Minimum value is 1, default 50.
Thông Tin Bổ Sung Additional optional filters to refine the metafield query:
- Namespace Filter metafields by their namespace string.
- Key Filter metafields by their key string.
- Tạo Sau Filter metafields created after this date/time (ISO 8601 format).
- Tạo Trước Filter metafields created before this date/time (ISO 8601 format).

Output

The output is an array containing one object with a json property holding the metafield data retrieved from the Sapo API. For the "Lấy Danh Sách" operation, the json field contains a list of metafields matching the specified filters and limits.

Each metafield object typically includes properties such as:

  • namespace: The metafield's namespace.
  • key: The metafield's key.
  • value: The stored value.
  • value_type: The type of the value (e.g., string).
  • description: Description of the metafield.
  • Other metadata like creation timestamps may also be included depending on the API response.

No binary data output is produced by this node.

Dependencies

  • Requires connection to the Sapo platform via an API key credential configured in n8n.
  • Uses the internal Sapo API base class to perform authenticated requests to manage metafields.
  • The node depends on proper configuration of the Sapo API credentials in n8n to function correctly.

Troubleshooting

  • Common issues:

    • Invalid or missing resource ID will cause the API call to fail.
    • Incorrect or expired API credentials will result in authentication errors.
    • Using invalid filter values (e.g., malformed dates) may cause request failures.
    • Requesting too many results without enabling "return all" might lead to truncated data.

  • Error messages:

    • Errors from the Sapo API are caught and either thrown or returned as error objects if "Continue On Fail" is enabled.
    • Typical error messages include authentication failures, resource not found, or invalid parameters.

  • Resolutions:

    • Verify the resource ID corresponds to an existing blog.
    • Ensure API credentials are valid and have sufficient permissions.
    • Validate filter inputs before running the node.
    • Use "Trả Về Tất Cả" option carefully to avoid performance issues with very large datasets.

Links and References

Discussion