Accounts-accountId-products-productId-services-serviceId:GET

From Hostway API Documentation
Revision as of 07:50, 15 September 2014 by Mike.robski (Talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

GET /accounts/{accountId}/products/{productId}/services/{serviceId}

Get service information.

Contents

Request

GET /accounts/{accountId}/products/{productId}/services/{serviceId}

Parameters

accountId - string
The Id of the account.
productId - string
The Id of the product.
serviceId - string
The Id of the service.

Request Headers

Authorization - HTTP Authorization header [1]
The Authentication credentials of the client application.

Response

Status Code

200 OK
Success.
401 Unauthorized
Authorization credentials not submitted or invalid.
404 Not Found
The account, product Id or service Id not found.

Response Body

{
  "status": "open",
  "name": "Service Name", 
  "displayName": "service-related-domain.com",
  "billingCycle": 12,
  "serviceSpecification": "https://api.hostway.com/serviceSpecifications/{serviceSpecificationId}",
  "links": [
    {
      "href": "https://api.hostway.com/accounts/{accountId}/products/{productId}/services/{serviceId}", 
      "rel": "self"
    },
    {
      "href": "https://api.hostway.com/{detailsLink}", 
      "rel": "manage"
    }
  ]
}
 

Parameters

status - string
Current status of the service. Allowed values are new, pending, open, suspended, close_pending, closed and purge_pending.
name - string
Name of the service.
displayName - string
Domain name for the service if any exists.
billingCycle - integer
Billing cycle of the service in months.
serviceSpecification - string
Link to the specification of the current service.
links - list
self - Hypermedia for the service resource
manage - Hypermedia for some service types. detailsLink format is:
for Domain type: domains/{domainName}/details. Please see: Domains-domainName-details:GET
for Email type: accounts/{accountId}/email/{domainName}. Please see: Accounts-account-email-domain:GET
for Exchange type: accounts/{accountId}/exchange/{domainName}/mailboxes. Please see: GET Exchange Mailboxes list
for Dedicated Server type: accounts/{accountId}/dedicatedServers/{serverId}. Please see: Accounts-account-dedicatedServers-server:GET

See also


blog comments powered by Disqus

Personal tools
Namespaces
Variants
Actions
APIs
Navigation
Toolbox