Printcart icon

Printcart

Consume Prinrcart API
Join our community

Actions83

Overview

This node integrates with the Printcart API to manage "Side" resources, specifically allowing users to retrieve a list of sides associated with products. The "Get List of Side" operation fetches multiple side entries with options to limit the number of results, sort them, and filter by status.

Typical use cases include:

  • Retrieving all design sides available for products in a Printcart store.
  • Filtering sides by their publication status (e.g., published, draft, trashed).
  • Sorting sides by specific fields such as ID in ascending or descending order.
  • Limiting the number of sides returned to optimize performance or pagination.

For example, a user might want to get the first 10 published sides sorted by their ID in descending order to display on a dashboard or process further in an automation workflow.

Properties

Name Meaning
Authentication Method of authentication; currently supports only "API Token".
Limit Maximum number of side records to return (minimum 10).
Sort Collection specifying sorting direction: "Asc" (ascending) or "Desc" (descending).
Sort By Field name to sort the sides by; defaults to "id".
Get By Status Filter sides by status type: "Publish", "Draft", or "Trashed".

Output

The node outputs a JSON array where each element represents a side resource retrieved from the Printcart API. Each side object typically includes details such as:

  • id: Unique identifier of the side.
  • product_id: Identifier of the product this side belongs to.
  • name: Name of the side.
  • bg_type: Background type of the side.
  • bg_color_value: Background color value.
  • scale: Scale factor.
  • side_image_size: Object containing width and height of the side image.
  • design_area: Object defining the design area dimensions and position.
  • side_image_id: Identifier of the associated side image.
  • status: Current status of the side (e.g., published, draft).

No binary data output is indicated for this operation.

Dependencies

  • Requires an API token credential for authenticating requests to the Printcart API.
  • The node makes HTTP requests to the Printcart API endpoints over HTTPS.
  • No additional external dependencies are required beyond standard n8n HTTP request helpers.

Troubleshooting

  • Common Issues:

    • Invalid or missing API token will cause authentication failures.
    • Requesting fewer than 10 items for the limit property may be rejected due to minimum value constraints.
    • Incorrect status values or sort parameters may result in empty responses or errors.

  • Error Messages:

    • Authentication errors typically indicate invalid or expired API tokens; ensure the token is valid and correctly configured.
    • HTTP 4xx or 5xx errors from the API suggest issues with request parameters or server-side problems; verify parameter correctness and retry later.
    • Network connectivity issues can prevent API calls; check internet access and firewall settings.

  • Resolution Tips:

    • Double-check the API token credential setup in n8n.
    • Use valid status and sort option values as specified.
    • Ensure the limit is set to 10 or higher.
    • Review API endpoint URLs if custom configurations are used.

Links and References

Discussion