Developer-Focused Guide

This documentation provides comprehensive details for integrating Waysorted's suite of design file processing APIs into your applications. These APIs power key features in the Waysorted Figma plugin ecosystem, enabling efficient handling of EPS, PDF, PSD, and related formats. Built on FastAPI for robustness and scalability, they emphasize secure file handling, asynchronous processing where needed, and JSON-based responses for easy parsing.

The APIs are optimized for server-to-server calls from design tools, CI/CD pipelines, or custom scripts. All operations respect Waysorted's credit system, where complex tasks (e.g., high-DPI conversions) consume variable credits—tracked via your account dashboard. For production use, monitor credit balances to avoid interruptions.

Key principles:

• Idempotency: Use job IDs in requests to retry safely without duplicates.
• Error Handling: Standardized JSON errors with HTTP status codes (e.g., { "error": "InvalidFileType", "message": "Only EPS files supported" }).
• File Security: Temporary signed URLs for uploads/downloads; files auto-delete after 24 hours.
• Versioning: All endpoints prefixed with /v1/ for future-proofing.

Last updated: December 2025. Need help? Contact info@waysorted.com or submit feedback via Report a Bug.