(Swift 2) Interfax -- Fax a Single Document

Demonstrates how to use the REST API to fax a single document using interfax.net. See Send fax for more information.

This example will send a POST with these potential query params:

POST /outbound/faxes?faxNumber={faxnumber}[&contact={string}&postponeTime={datetime}
&retriesToPerform={number}&csid={string}&pageHeader={string}&reference={string}
&replyAddress={email}&pageSize={a4|letter|legal|b4}&fitToPage={scale|noscale}
&pageOrientation={portrait|landscape}&resolution={fine|standard}&rendering={greyscale|bw}]

POST /outbound/faxes?faxNumber={faxnumber}&... HTTP/1.1
Host: rest.interfax.net
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/msword
 
{binary content goes here}

Chilkat Downloads for the Swift Programming Language MAC OS X (Cocoa) Objective-C/Swift Libs iOS Objective-C/Swift Libs

func chilkatTest() {
    // This example requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    let rest = CkoRest()

    // Use Basic Authentication.
    // Use your InterFAX login and password.
    var success: Bool = rest.SetAuthBasic("INTERFAX_LOGIN", password: "INTERFAX_PASSWORD")

    // Connect to the Interfax REST server.
    // Make sure TLS is used.  One should NEVER send a username+password using Basic authentication
    // over a non-secure connection.
    var bTls: Bool = true
    var port: Int = 443
    var bAutoReconnect: Bool = true
    success = rest.Connect("rest.interfax.net", port: port, tls: bTls, autoReconnect: bAutoReconnect)

    // Indicate the Content-Type of our upload.  
    // We're faxing a PDF, so set the content-type to application/pdf.
    success = rest.AddHeader("Content-Type", value: "application/pdf")

    // We can add an "Expect: 100-continue" header so that if the request is rejected
    // by the server immediately after receiving the request header, it can respond
    // and the client (Chilkat) can avoid sending the file data.
    // (this is optional)
    success = rest.AddHeader("Expect", value: "100-continue")

    let fileStream = CkoStream()

    // The stream's source will be a file.
    fileStream.SourceFile = "qa_data/pdf/fishing.pdf"

    // Add query params.
    // The fax number format is "+1-212-3456789"
    rest.AddQueryParam("faxNumber", value: "MY-FAX-NUMBER")
    rest.AddQueryParam("pageSize", value: "letter")
    // Add any other desired query params ...

    // The response is a 0-length "201 Created" response.
    // Therefore the responseStr will be empty.
    var responseStr: String? = rest.FullRequestStream("POST", uriPath: "/outbound/faxes", stream: fileStream)
    if rest.LastMethodSuccess != true {
        print("\(rest.LastErrorText)")
        return
    }

    if rest.ResponseStatusCode.intValue != 201 {
        // The response was not successful.
        // We can examine the response code, header and status text:
        print("Response status code: \(rest.ResponseStatusCode.intValue)")
        print("Response status text: \(rest.ResponseStatusText)")
        print("Response header: \(rest.ResponseHeader)")
        print("FAX failed.")
    }
    else {
        print("FAX sent.")
    }


}