GET | /accounts |
---|
import Foundation
import ServiceStack
/**
* Retrieve a list of accounts
*/
// @Api(Description="Retrieve a list of accounts")
public class ListAccounts : ListRequest<AccountInfo>
{
/**
* Filter the results by name
*/
// @ApiMember(Description="Filter the results by name")
public var nameFilter:String?
required public init(){ super.init() }
private enum CodingKeys : String, CodingKey {
case nameFilter
}
required public init(from decoder: Decoder) throws {
try super.init(from: decoder)
let container = try decoder.container(keyedBy: CodingKeys.self)
nameFilter = try container.decodeIfPresent(String.self, forKey: .nameFilter)
}
public override func encode(to encoder: Encoder) throws {
try super.encode(to: encoder)
var container = encoder.container(keyedBy: CodingKeys.self)
if nameFilter != nil { try container.encode(nameFilter, forKey: .nameFilter) }
}
}
public class ListRequest<T : Codable> : IGet, Codable
{
/**
* The page of data to retrieve
*/
// @ApiMember(Description="The page of data to retrieve")
public var page:Int?
/**
* If you want all objects to be returned. This should be used with care
*/
// @ApiMember(Description="If you want all objects to be returned. This should be used with care")
public var all:Bool?
/**
* The number per page to retrieve
*/
// @ApiMember(Description="The number per page to retrieve")
public var countPerPage:Int?
/**
* Specific IDs
*/
// @ApiMember(Description="Specific IDs")
public var specificIds:[String] = []
/**
* Specify a sort field
*/
// @ApiMember(Description="Specify a sort field")
public var sortField:String?
/**
* Specify a sort order
*/
// @ApiMember(Description="Specify a sort order")
public var sortOrder:SortOrders?
/**
* Disables total / page counts - improves performance. Returns only data. If there is no more data, Items will be empty array
*/
// @ApiMember(Description="Disables total / page counts - improves performance. Returns only data. If there is no more data, Items will be empty array")
public var simplifiedPaging:Bool?
required public init(){}
}
public enum SortOrders : String, Codable
{
case Ascend
case Descend
}
public class AccountInfo : EntityInfo
{
/**
* The name of this account
*/
// @ApiMember(Description="The name of this account")
public var name:String?
/**
* The ID of this account's parent
*/
// @ApiMember(Description="The ID of this account's parent")
public var parentAccountId:String?
/**
* The twilio account SID
*/
// @ApiMember(Description="The twilio account SID")
public var twilioAccountSid:String?
/**
* The ancestors of this account. Useful for breadcrumbs
*/
// @ApiMember(Description="The ancestors of this account. Useful for breadcrumbs")
public var ancestorIds:[String] = []
/**
* The max number of phone numbers this account can have
*/
// @ApiMember(Description="The max number of phone numbers this account can have")
public var maxPhoneNumbers:Int?
/**
* This account is BYOA
*/
// @ApiMember(Description="This account is BYOA")
public var isBYOA:Bool?
/**
* TrustHub Profile Sid
*/
// @ApiMember(Description="TrustHub Profile Sid")
public var trustHubProfileSid:String?
/**
* The ID of the logo file
*/
// @ApiMember(Description="The ID of the logo file")
public var logoId:String?
/**
* The URI of the logo file
*/
// @ApiMember(Description="The URI of the logo file")
public var logoUri:String?
/**
* The billing settings for this account
*/
// @ApiMember(Description="The billing settings for this account")
public var billingSettings:BillingSettings?
required public init(){ super.init() }
private enum CodingKeys : String, CodingKey {
case name
case parentAccountId
case twilioAccountSid
case ancestorIds
case maxPhoneNumbers
case isBYOA
case trustHubProfileSid
case logoId
case logoUri
case billingSettings
}
required public init(from decoder: Decoder) throws {
try super.init(from: decoder)
let container = try decoder.container(keyedBy: CodingKeys.self)
name = try container.decodeIfPresent(String.self, forKey: .name)
parentAccountId = try container.decodeIfPresent(String.self, forKey: .parentAccountId)
twilioAccountSid = try container.decodeIfPresent(String.self, forKey: .twilioAccountSid)
ancestorIds = try container.decodeIfPresent([String].self, forKey: .ancestorIds) ?? []
maxPhoneNumbers = try container.decodeIfPresent(Int.self, forKey: .maxPhoneNumbers)
isBYOA = try container.decodeIfPresent(Bool.self, forKey: .isBYOA)
trustHubProfileSid = try container.decodeIfPresent(String.self, forKey: .trustHubProfileSid)
logoId = try container.decodeIfPresent(String.self, forKey: .logoId)
logoUri = try container.decodeIfPresent(String.self, forKey: .logoUri)
billingSettings = try container.decodeIfPresent(BillingSettings.self, forKey: .billingSettings)
}
public override func encode(to encoder: Encoder) throws {
try super.encode(to: encoder)
var container = encoder.container(keyedBy: CodingKeys.self)
if name != nil { try container.encode(name, forKey: .name) }
if parentAccountId != nil { try container.encode(parentAccountId, forKey: .parentAccountId) }
if twilioAccountSid != nil { try container.encode(twilioAccountSid, forKey: .twilioAccountSid) }
if ancestorIds.count > 0 { try container.encode(ancestorIds, forKey: .ancestorIds) }
if maxPhoneNumbers != nil { try container.encode(maxPhoneNumbers, forKey: .maxPhoneNumbers) }
if isBYOA != nil { try container.encode(isBYOA, forKey: .isBYOA) }
if trustHubProfileSid != nil { try container.encode(trustHubProfileSid, forKey: .trustHubProfileSid) }
if logoId != nil { try container.encode(logoId, forKey: .logoId) }
if logoUri != nil { try container.encode(logoUri, forKey: .logoUri) }
if billingSettings != nil { try container.encode(billingSettings, forKey: .billingSettings) }
}
}
public class EntityInfo : Codable
{
/**
* The ID of the object
*/
// @ApiMember(Description="The ID of the object")
public var id:String?
/**
* The date the object was created
*/
// @ApiMember(Description="The date the object was created")
public var dateCreated:String?
/**
* The date the object was last modified
*/
// @ApiMember(Description="The date the object was last modified")
public var dateLastModified:String?
/**
* The user that created this object
*/
// @ApiMember(Description="The user that created this object")
public var createdBy:String?
/**
* The user that last modified this object
*/
// @ApiMember(Description="The user that last modified this object")
public var lastModifiedBy:String?
required public init(){}
}
public class BillingSettings : Codable
{
public var base:BillingItem?
public var localNumbers:BillingItem?
public var tollFreeNumbers:BillingItem?
public var inboundVoiceCalls:BillingItem?
public var outboundVoiceCalls:BillingItem?
public var inboundFaxes:BillingItem?
public var outboundFaxes:BillingItem?
public var inboundSmsMessages:BillingItem?
public var outboundSmsMessages:BillingItem?
required public init(){}
}
public class BillingItem : Codable
{
public var baseCost:Double?
public var rawUnitMultiplier:Double?
public var unitCost:Double?
public var allowance:Int?
required public init(){}
}
public class ListResponse<AccountInfo : Codable> : Codable
{
/**
* The items
*/
// @ApiMember(Description="The items")
public var items:[AccountInfo] = []
/**
* The total number of items
*/
// @ApiMember(Description="The total number of items")
public var totalCount:Int?
/**
* The total number of pages
*/
// @ApiMember(Description="The total number of pages")
public var totalPages:Int?
/**
* Are there more pages of items? Used with simplified paging
*/
// @ApiMember(Description="Are there more pages of items? Used with simplified paging")
public var hasMorePages:Bool?
required public init(){}
}
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /accounts HTTP/1.1 Host: evovoice.io Accept: application/xml
HTTP/1.1 200 OK Content-Type: application/xml Content-Length: length <ListResponseOfAccountInfoLIonMsk5 xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Voice.Api"> <HasMorePages>false</HasMorePages> <Items xmlns:d2p1="http://schemas.datacontract.org/2004/07/Voice.Api.Accounts"> <d2p1:AccountInfo> <CreatedBy>String</CreatedBy> <DateCreated>String</DateCreated> <DateLastModified>String</DateLastModified> <Id>String</Id> <LastModifiedBy>String</LastModifiedBy> <d2p1:AncestorIds xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d4p1:string>String</d4p1:string> </d2p1:AncestorIds> <d2p1:BillingSettings> <d2p1:Base> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:Base> <d2p1:InboundFaxes> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:InboundFaxes> <d2p1:InboundSmsMessages> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:InboundSmsMessages> <d2p1:InboundVoiceCalls> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:InboundVoiceCalls> <d2p1:LocalNumbers> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:LocalNumbers> <d2p1:OutboundFaxes> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:OutboundFaxes> <d2p1:OutboundSmsMessages> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:OutboundSmsMessages> <d2p1:OutboundVoiceCalls> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:OutboundVoiceCalls> <d2p1:TollFreeNumbers> <d2p1:Allowance>0</d2p1:Allowance> <d2p1:BaseCost>0</d2p1:BaseCost> <d2p1:RawUnitMultiplier>0</d2p1:RawUnitMultiplier> <d2p1:UnitCost>0</d2p1:UnitCost> </d2p1:TollFreeNumbers> </d2p1:BillingSettings> <d2p1:IsBYOA>false</d2p1:IsBYOA> <d2p1:LogoId>String</d2p1:LogoId> <d2p1:LogoUri>String</d2p1:LogoUri> <d2p1:MaxPhoneNumbers>0</d2p1:MaxPhoneNumbers> <d2p1:Name>String</d2p1:Name> <d2p1:ParentAccountId>String</d2p1:ParentAccountId> <d2p1:TrustHubProfileSid>String</d2p1:TrustHubProfileSid> <d2p1:TwilioAccountSid>String</d2p1:TwilioAccountSid> </d2p1:AccountInfo> </Items> <TotalCount>0</TotalCount> <TotalPages>0</TotalPages> </ListResponseOfAccountInfoLIonMsk5>