Difference between revisions of "Customer (Rest API)"
From Rackspace Email & Apps API
m |
(remove account setting info) |
||
| Line 92: | Line 92: | ||
''Description'': | ''Description'': | ||
| − | Add/Edit a new sub-account. Because the customer number is not known until the customer is added, the POST data will be sent to '/customers' | + | Add/Edit a new sub-account. Because the customer number is not known until the customer is added, the POST data will be sent to '/customers'. |
| Line 107: | Line 107: | ||
| string | | string | ||
| The reference number of this account | | The reference number of this account | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
|} | |} | ||
Revision as of 14:17, 28 August 2009
Contents
Customer
Index
URL:
[GET] /customers
Description:
This operation returns the list of customers that the authenticated user has access to.
Remarks:
For the text/xml format, refer to the following schema document: [Customers.xsd]
Example:
get '/customers?size=100&page=1&referenceNumber=102486', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 406 | Invalid format |
Show
URL:
[GET] /customers/(customer account number)
Description:
The show operation will return detailed information about the specified account.
Remarks:
The show operation only supports the GET HTTP verb. For text/xml format, refer to the following schema document: [Customer.xsd]
Example:
get '/customers/999999', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 406 | Invalid format |
| Customer account number is invalid | 404 | Invalid account number |
Add/Edit
URL:
Add: [POST] /customers
Edit: [PUT] /customers/(customer account number)
Description:
Add/Edit a new sub-account. Because the customer number is not known until the customer is added, the POST data will be sent to '/customers'.
| Field Name | Data Type | Description |
|---|---|---|
| name | string | The customer's display name (Required for Add) |
| referenceNumber | string | The reference number of this account |
Example:
post '/customers', 'text/xml',
{
'name' => 'Name'
}
put '/customers/999999', 'text/xml',
{
'name' => 'NewName',
'referenceNumber' => '12345'
}
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 406 | Invalid format |
| The name field was not specified | 400 | Missing required field: name |
| The name field cannot be blank | 400 | Required field name cannot be empty |
| Names cannot start with a space | 400 | Improper Customer Name |
| The customer account was not found | 404 | Customer Not Found |
Delete
URL:
[DELETE] /customers/(customer account number)
Description:
Deletes the account.
Example:
delete '/customers/999999', 'text/xml'
Errors:
| Description | HTTP Response Code | Sample Message |
|---|---|---|
| Format is invalid | 406 | Invalid format |
| The customer account was not found | 404 | Customer Not Found |
