/orders

Create a new order

Create a new order with a POST request to /orders. Include a JSON object containing a unique order id. A successful request will return the order object that was created.

Order IDs

You are responsible for providing a unique Order ID. You must continue to use this Order ID in all further requests that pertain to the resource that was requested. The benefit of being able to choose your own Order ID is that you do not need to store a unique identifier that was generated by us to access your own resources.

An attempt to create a new order with an Order ID that already exists will result in a 409 Conflict HTTP Response with a corresponding message in JSON format.

Sample Request:

Shell

curl -i https://api.vift.com/orders \
		 -u YOUR_APP_ID:YOUR_API_KEY \
		 -H "Content-Type: application/json" \
     -X POST \
     -d '{
           "id": "YOUR_ORDER_ID",
           "name": "John Doe",
           "email": "[email protected]",
           "recipient_name": "Jane Doe",
           "recipient_email": "[email protected]",
           "price": 195
         }'