Step-by-Step Guide
Step-by-Step Workflow Overview
Last updated
Step-by-Step Workflow Overview
Last updated
This roadmap will guide you through every step of the process, ensuring that you know exactly what to do, how to do it, and why each step matters. Each section includes step-by-step instructions, common issues to avoid, and helpful tips to make your experience seamless.
Goal: Gain access to the system by obtaining your API key and configuring your webhook for real-time updates.
Log in to your account.
Go to the Section.
Generate or Copy your API key.
Set Your Webhook URL where you will receive updates and callbacks.
Security Tip: Treat your API key like a password. Don’t expose it publicly or share it with others.
Webhook URL: Make sure the URL is live, accessible, and ready to receive incoming requests.
Invalid API Key: Double-check that you’ve copied the key correctly.
Webhook Not Triggering: Ensure your server can receive POST requests and is not blocking unknown IPs.
Goal: Use your API key to verify and authorize every request you send to the system.
Add Your API Key to the header of every request as:
API Key Regeneration: If your key is compromised, regenerate it immediately.
Common Error: “401 Unauthorized” — This means your API key might be missing or incorrect.
Goal: Upload images to the server's storage system in preparation for order submission.
Prepare the Image File JPG
,PNG
,etc.
Send a POST Request to the API endpoint with the image file as form-data.
Receive the Response: The server will return a unique image identifier image_id
.
File Size: Ensure your image is within the file size limits.
Supported Formats: Check which image formats are allowed JPG
,PNG
, etc.
Goal: Submit an order and specify the service, spaces, widgets, and other parameters required to fulfill the order.
Prepare Order Data:
Select the service you want to use.
Identify the spaces, widgets and items for the service.
Include the image_id from the previous step.
Webhook URL: Ensure your webhook is active, as the order status will be sent there.
Common Issues:
Missing Image ID: Ensure you provide the correct image identifier image_id
.
Missing Service Data: Make sure to retrieve and understand the correct spaces, widgets, and items before submitting.
Goal: Retrieve detailed information on a submitted order to check its progress or result.
Review the Response: The response will include the current status, progress, and final result.
Check Status: Possible statuses may include in-progress or idle.
Order Tracking: If an order is taking longer than expected, track it using this endpoint.
Polling vs Webhook: Rely on the webhook for real-time updates, but you can also use this endpoint to manually check progress.
Access the Section of the API.
Retrieve Service Details: Get the list of available , of each service via API endpoints.
Submit the Order: Send a POST request to the endpoint.
Wait for the Webhook Callback: Once the order is processed, a will send the result back to your specified URL.
Submit a GET Request: Use the endpoint.