Order Management

Requests grouped to order management let you retrieve information about your orders, both where you're buyer or seller, as well as change their states (mark them as sent, received, etc.).

Resource Allowed HTTP Methods Description
/order/:idOrder GET Returns the Order entity specified by its ID.
PUT Updates the state of the order - it can be marked as sent, as received, can be cancelled, or a cancellation can be requested, resp. the cancellation request can be accepted.
/order/:idOrder/evaluation POST Evaluates an order specified by its ID.
/orders/:actor/:state[/:start] GET Returns a collection of orders specified by the actor parameter (buyer or seller) and the state parameter (bought, paid, sent, received, lost, cancelled). Only orders for the authenticated user are returned.

Basically the requests returns the complete collection of filtered orders. By specifying the start parameter, the response can be limited to 100 entities.