Revision as of 00:59, 17 February 2013

Ordering API

The ordering API supports the operations of creating, building and placing orders. The orders are the main method of creating new accounts and adding and managing the products for an account.

download this selection of articles as a PDF book

Orders

Order management resources.

• POST /orders - Creates a new order
• GET /orders/{orderId} - Returns order details
• DELETE /orders/{orderId} - Deletes an order
• POST /orders/{orderId}/action - Performs an action on an order

Order Shorthand

An URL shortcut allowing the user to access the currently open order without specifying the order ID.

• Order Shorthand

Account

Customer information in a given order. Only one account is allowed per order.

• PUT /orders/{orderId}/account - Add account to the order
• GET /orders/{orderId}/account - Returns the account details

Account Attributes

Custom attributes for an Account in a given Order.

• PUT /orders/{orderId}/account/attributes - Sets account attributes
• GET /orders/{orderId}/account/attributes - Returns account attributes
• DELETE /orders/{orderId}/account/attributes - Deletes all account attributes

Account Contact Info

Various types of Contact Info set for an Account in a given Order.

• PUT /orders/{orderId}/account/contactInfo/{contactType} - Set contact details
• GET /orders/{orderId}/account/contactInfo{contactType} - Returns contact details
• GET /orders/{orderId}/account/contactInfo - Returns all account contacts
• DELETE /orders/{orderId}/account/contactInfo/{contactType} - Deletes specific contact

Account Payment Information

Payment method information for an Account in a given Order. An account cannot have multiple payment methods.

• PUT /orders/{orderId}/account/paymentInfo - Sets the payment method for an account
• GET /orders/{orderId}/account/paymentInfo - Returns the payment method for an account

Account User

User information for an Account in a given Order.

• PUT /orders/{orderId}/account/user - Sets the account user credentials
• GET /orders/{orderId}/account/user - Returns information about account user credentials

Products

Products included in the order.

• POST /orders/{orderId}/account/products - Adds product to the account
• GET /orders/{orderId}/account/products - Gets all products
• GET /orders/{orderId}/account/products/{productId} - Gets the product details
• DELETE /orders/{orderId}/account/products/{productId} - Removes product from the order

Services

Services included in the products.

• POST /orders/{orderId}/account/products/{productId}/services - Adds service to a product
• GET /orders/{orderId}/account/products/{productId}/services - Gets all services for a product
• GET /orders/{orderId}/account/products/{productId}/services/{serviceId} - Gets service details
• DELETE /orders/{orderId}/account/products/{productId}/services/{serviceId} - Removes service from a product

Service Attributes

Attributed for the included services.

• PUT /orders/{orderId}/account/products/{productId}/services/{serviceId}/attributes - Adds service attributes
• GET /orders/{orderId}/account/products/{productId}/services/{serviceId}/attributes - Gets service attributes
• OPTIONS /orders/{orderId}/account/products/{productId}/services/{serviceId}/attributes - Returns information about supported attributes

Order Quote

Quote information for a given order.

• GET /orders/{orderId}/quote - Returns quote for the products and services in the order

See also

• Common Features