POST, PUT | /documents/download |
---|
import Foundation
import ServiceStack
public class ClientDownloadRequest : DocumentRequestBase
{
public var fileName:String
/**
* Month
*/
// @ApiMember(Description="Month", ExcludeInSchema=true, IsRequired=true, ParameterType="path")
public var month:Int
/**
* Day
*/
// @ApiMember(Description="Day", ExcludeInSchema=true, IsRequired=true, ParameterType="path")
public var day:Int
required public init(){ super.init() }
private enum CodingKeys : String, CodingKey {
case fileName
case month
case day
}
required public init(from decoder: Decoder) throws {
try super.init(from: decoder)
let container = try decoder.container(keyedBy: CodingKeys.self)
fileName = try container.decodeIfPresent(String.self, forKey: .fileName)
month = try container.decodeIfPresent(Int.self, forKey: .month)
day = try container.decodeIfPresent(Int.self, forKey: .day)
}
public override func encode(to encoder: Encoder) throws {
try super.encode(to: encoder)
var container = encoder.container(keyedBy: CodingKeys.self)
if fileName != nil { try container.encode(fileName, forKey: .fileName) }
if month != nil { try container.encode(month, forKey: .month) }
if day != nil { try container.encode(day, forKey: .day) }
}
}
public class DocumentRequestBase : Codable
{
/**
* ExternalID
*/
// @ApiMember(Description="ExternalID", ExcludeInSchema=true, IsRequired=true, ParameterType="path")
public var externalId:String
required public init(){}
}
public class ClientDownloadResponse : ResponseBase
{
public var fileName:String
public var stream:Data
required public init(){ super.init() }
private enum CodingKeys : String, CodingKey {
case fileName
case stream
}
required public init(from decoder: Decoder) throws {
try super.init(from: decoder)
let container = try decoder.container(keyedBy: CodingKeys.self)
fileName = try container.decodeIfPresent(String.self, forKey: .fileName)
stream = try container.decodeIfPresent(Data.self, forKey: .stream)
}
public override func encode(to encoder: Encoder) throws {
try super.encode(to: encoder)
var container = encoder.container(keyedBy: CodingKeys.self)
if fileName != nil { try container.encode(fileName, forKey: .fileName) }
if stream != nil { try container.encode(stream, forKey: .stream) }
}
}
public class ResponseBase : Codable
{
public var message:String
public var isSuccess:Bool
required public init(){}
}
Swift ClientDownloadRequest DTOs
To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json
To embed the response in a jsonp callback, append ?callback=myCallback
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /documents/download HTTP/1.1
Host: initiation-pen.sirva.com
Accept: application/json
Content-Type: application/json
Content-Length: length
{"FileName":"String","Month":0,"Day":0,"ExternalId":"String"}
HTTP/1.1 200 OK Content-Type: application/json Content-Length: length {"FileName":"String","Message":"String","IsSuccess":false}