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



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


   ["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