LOGO
LOGO
 
Log in
Get Started

API Documentation

Current Version: 2.0

This API allows you to create and manage your orders with Tucia in a simple, programmatic way using conventional HTTP requests. The endpoints are intuitive and powerful, allowing you to easily make calls to retrieve information or to execute actions.

With this API, you are able to add Tucia's human-powered photo editing functionality to any application. This is especially useful for resellers who have their own websites or apps, and outsource the real editing service to Tucia.

 

Add reference images

HTTP Request:

POST /orders/:order_id/refimages/create

Attach a new reference image to an existing order

 

Query Parameters:

Name Type Description

images

json
required

Each element in the represents 1 image, containing 2 parameters:
1. publicly accessible url of the image;
2. an optional instruction only applying to this image

example:

[
   ["http:\/\/abc.com\/ref1.jpg", "reference for eye color"],
   ["http:\/\/abc.com\/ref2.jpg", "same face shape like this image"]
]

Example successful response:


{
    "errors": [],
    "data": {
      "order_id": "UVWXYZ123",
      "project_name": "John's wedding",
      "customer_id": 1234,
      "price": 3,
      "status": "revising",
      "revision": 2,
      "ordered_at": "2017-12-02T16:00:00+04:00",
      "revision_requested_at": "2017-12-03T16:00:00+04:00",
      "estimated_delivery": "2017-12-05T12:00:00+04:00"
    }
}

Example error response:


{
    "errors": [
      "Please do not post duplicated images"
    ]
}

 

Next: Revise order