Requires the role: | manager |
POST | /cars |
---|
import Foundation
import ServiceStack
public class CreateCarRequest : PostOperationTenanted<CreateCarResponse>
{
public var year:Int?
public var make:String?
public var model:String?
required public init(){ super.init() }
private enum CodingKeys : String, CodingKey {
case year
case make
case model
}
required public init(from decoder: Decoder) throws {
try super.init(from: decoder)
let container = try decoder.container(keyedBy: CodingKeys.self)
year = try container.decodeIfPresent(Int.self, forKey: .year)
make = try container.decodeIfPresent(String.self, forKey: .make)
model = try container.decodeIfPresent(String.self, forKey: .model)
}
public override func encode(to encoder: Encoder) throws {
try super.encode(to: encoder)
var container = encoder.container(keyedBy: CodingKeys.self)
if year != nil { try container.encode(year, forKey: .year) }
if make != nil { try container.encode(make, forKey: .make) }
if model != nil { try container.encode(model, forKey: .model) }
}
}
public class PostOperationTenanted<TResponse : Codable> : PostOperationUnTenanted<TResponse>, ITenantedRequest
{
public var organisationId:String?
required public init(){ super.init() }
private enum CodingKeys : String, CodingKey {
case organisationId
}
required public init(from decoder: Decoder) throws {
try super.init(from: decoder)
let container = try decoder.container(keyedBy: CodingKeys.self)
organisationId = try container.decodeIfPresent(String.self, forKey: .organisationId)
}
public override func encode(to encoder: Encoder) throws {
try super.encode(to: encoder)
var container = encoder.container(keyedBy: CodingKeys.self)
if organisationId != nil { try container.encode(organisationId, forKey: .organisationId) }
}
}
public class PostOperationUnTenanted<TResponse : Codable> : IPost, Codable
{
required public init(){}
}
public class CreateCarResponse : Codable
{
public var responseStatus:ResponseStatus?
public var car:Car?
required public init(){}
}
public class Car : IIdentifiableResource, Codable
{
public var manufacturer:CarManufacturer?
public var plate:CarLicensePlate?
public var owner:CarOwner?
public var managers:[CarManager] = []
public var status:String?
public var altered:Bool?
public var id:String?
required public init(){}
}
public class CarManufacturer : Codable
{
public var year:Int?
public var make:String?
public var model:String?
required public init(){}
}
public class CarLicensePlate : Codable
{
public var jurisdiction:String?
public var number:String?
required public init(){}
}
public class CarOwner : Codable
{
public var id:String?
required public init(){}
}
public class CarManager : Codable
{
public var id:String?
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.
POST /cars HTTP/1.1
Host: staging-api.billiecart.com.au
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<CreateCarRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Infrastructure.Api.Interfaces.ServiceOperations.Cars">
<OrganisationId xmlns="http://schemas.datacontract.org/2004/07/Infrastructure.Api.Interfaces.ServiceOperations">String</OrganisationId>
<Make>String</Make>
<Model>String</Model>
<Year>0</Year>
</CreateCarRequest>
HTTP/1.1 200 OK Content-Type: application/xml Content-Length: length <CreateCarResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Infrastructure.Api.Interfaces.ServiceOperations.Cars"> <Car xmlns:d2p1="http://schemas.datacontract.org/2004/07/Application.Interfaces.Resources"> <d2p1:Altered>false</d2p1:Altered> <d2p1:Id>String</d2p1:Id> <d2p1:Managers> <d2p1:CarManager> <d2p1:Id>String</d2p1:Id> </d2p1:CarManager> </d2p1:Managers> <d2p1:Manufacturer> <d2p1:Make>String</d2p1:Make> <d2p1:Model>String</d2p1:Model> <d2p1:Year>0</d2p1:Year> </d2p1:Manufacturer> <d2p1:Owner> <d2p1:Id>String</d2p1:Id> </d2p1:Owner> <d2p1:Plate> <d2p1:Jurisdiction>String</d2p1:Jurisdiction> <d2p1:Number>String</d2p1:Number> </d2p1:Plate> <d2p1:Status>String</d2p1:Status> </Car> <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types"> <d2p1:ErrorCode>String</d2p1:ErrorCode> <d2p1:Message>String</d2p1:Message> <d2p1:StackTrace>String</d2p1:StackTrace> <d2p1:Errors> <d2p1:ResponseError> <d2p1:ErrorCode>String</d2p1:ErrorCode> <d2p1:FieldName>String</d2p1:FieldName> <d2p1:Message>String</d2p1:Message> <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d5p1:KeyValueOfstringstring> <d5p1:Key>String</d5p1:Key> <d5p1:Value>String</d5p1:Value> </d5p1:KeyValueOfstringstring> </d2p1:Meta> </d2p1:ResponseError> </d2p1:Errors> <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d3p1:KeyValueOfstringstring> <d3p1:Key>String</d3p1:Key> <d3p1:Value>String</d3p1:Value> </d3p1:KeyValueOfstringstring> </d2p1:Meta> </ResponseStatus> </CreateCarResponse>