PopoOpenPlatform Api icon

PopoOpenPlatform Api

POPO OpenPlatform API

Actions6

Overview

The "云空间" (Cloud Space) resource with the "上传图片" (Upload Image) operation in this custom n8n node allows users to upload images to a cloud storage service via the POPO OpenPlatform API. This is useful for automating workflows that require storing, sharing, or processing images in a centralized cloud environment. Typical scenarios include:

  • Automatically saving user-uploaded images from forms or chatbots.
  • Backing up images generated or processed in other workflow steps.
  • Integrating image uploads into document management or collaboration systems.

Example Use Cases:

  • Uploading scanned receipts to a company drive for expense tracking.
  • Saving screenshots or photos from IoT devices to a shared folder.
  • Automating the archival of marketing assets or design files.

Properties

Name Type Meaning
Category options Specifies the category of the operation within 云空间 (Cloud Space). Options include 文件夹 (Folder), 文件上传 (File Upload), 文件操作 (File Operation), 用户中心 (User Center). For uploading images, this should be set to 文件上传 (upload).

Output

The output will be a JSON object (or array of objects) representing the result of the image upload operation. The exact structure depends on the API response, but typically includes fields such as:

  • status: Indicates success or failure of the upload.
  • fileId / imageId: Unique identifier for the uploaded image.
  • url / downloadUrl: Direct link to access the uploaded image.
  • message: Any additional information or error messages from the API.

Example Output:

{
  "status": "success",
  "imageId": "abc123",
  "url": "https://cloud.example.com/images/abc123"
}

If the API returns an array (e.g., for batch operations), the node will output an array of such objects.

Dependencies

  • External Service: Requires access to the POPO OpenPlatform API.
  • API Credentials: You must configure the popoOpenPlatformApi credentials in n8n for authentication.
  • n8n Configuration: No special environment variables are required beyond standard credential setup.

Troubleshooting

Common Issues:

  • Missing or Invalid Credentials: If the API key or credentials are not set up correctly, the node will fail to authenticate.
  • Incorrect Category Selection: Ensure "Category" is set to "文件上传" (upload) for image uploads; otherwise, the operation may not work as expected.
  • File Size or Format Restrictions: The API may reject files that exceed size limits or unsupported formats.

Error Messages and Resolutions:

  • 401 Unauthorized / Authentication Error: Check your API credentials in n8n.
  • 400 Bad Request: Verify all required parameters are provided and valid.
  • 500 Internal Server Error: This may indicate an issue with the external service; try again later or contact support.

Links and References

Discussion