(Swift 3,4,5...) ShippingEasy.com Calculate Signature for API Authentication

Demonstrates how to calculate the shippingeasy.com API signature for authenticating requests.

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.

    // 
    // First, concatenate these into a plaintext string using the following order:
    // 
    //     Capitilized method of the request. E.g. "POST"
    //     The URI path
    //     The query parameters sorted alphabetically and concatenated together into a URL friendly format: param1=ABC&param2=XYZ
    //     The request body as a string if one exists
    //     All parts are then concatenated together with an ampersand. The result resembles something like this:
    // 
    // "POST&/partners/api/accounts&api_key=f9a7c8ebdfd34beaf260d9b0296c7059&api_timestamp=1401803554&{ ... request body ... }"

    var success: Bool
    let sbStringToSign = CkoStringBuilder()!

    var httpVerb: String? = "POST"
    var uriPath: String? = "/partners/api/accounts"
    var queryParamsStr: String? = "api_key=YOUR_API_KEY&api_timestamp=UNIX_EPOCH_TIMESTAMP"

    // Build the following JSON that will be the body of the request:

    // {
    //   "account": {
    //     "first_name": "Coralie",
    //     "last_name": "Waelchi",
    //     "company_name": "Hegmann, Cremin and Bradtke",
    //     "email": "se_greg_6d477b1e59e8ff24abadfb59d3a2de3e@shippingeasy.com",
    //     "phone_number": "1-381-014-3358",
    //     "address": "2476 Flo Inlet",
    //     "address2": "",
    //     "state": "SC",
    //     "city": "North Dennis",
    //     "postal_code": "29805",
    //     "country": "USA",
    //     "password": "abc123",
    //     "subscription_plan_code": "starter"
    //   }
    // }

    let json = CkoJsonObject()!
    json.update("account.first_name", value: "Coralie")
    json.update("account.last_name", value: "Waelchi")
    json.update("account.company_name", value: "Hegmann, Cremin and Bradtke")
    json.update("account.email", value: "se_greg_6d477b1e59e8ff24abadfb59d3a2de3e@shippingeasy.com")
    json.update("account.phone_number", value: "1-381-014-3358")
    json.update("account.address", value: "2476 Flo Inlet")
    json.update("account.address2", value: "")
    json.update("account.state", value: "SC")
    json.update("account.city", value: "North Dennis")
    json.update("account.postal_code", value: "29805")
    json.update("account.country", value: "USA")
    json.update("account.password", value: "abc123")
    json.update("account.subscription_plan_code", value: "starter")

    json.emitCompact = false
    print("\(json.emit()!)")

    // First, let's get the current date/time in the Unix Epoch Timestamp format (which is just an integer)
    let dt = CkoDateTime()!
    dt.setFromCurrentSystemTime()
    // Get the UTC time.
    var bLocalTime: Bool = false
    var unixEpochTimestamp: String? = dt.getAsUnixTimeStr(bLocalTime)

    // Build the string to sign:
    sbStringToSign.append(httpVerb)
    sbStringToSign.append("&")
    sbStringToSign.append(uriPath)
    sbStringToSign.append("&")
    sbStringToSign.append(queryParamsStr)
    sbStringToSign.append("&")
    // Make sure to send the JSON body of a request in compact form..
    json.emitCompact = true
    sbStringToSign.append(json.emit())

    // Use your API key here:
    var your_api_key: String? = "f9a7c8ebdfd34beaf260d9b0296c7059"

    var numReplaced: Int = sbStringToSign.replace("YOUR_API_KEY", replacement: your_api_key).intValue
    numReplaced = sbStringToSign.replace("UNIX_EPOCH_TIMESTAMP", replacement: unixEpochTimestamp).intValue

    // Do the HMAC-SHA256 with your API secret:
    var your_api_secret: String? = "ea210785fa4656af03c2e4ffcc2e7b5fc19f1fba577d137905cc97e74e1df53d"
    let crypt = CkoCrypt2()!
    crypt.macAlgorithm = "hmac"
    crypt.encodingMode = "hexlower"
    crypt.setMacKeyString(your_api_secret)
    crypt.hashAlgorithm = "sha256"

    var api_signature: String? = crypt.macStringENC(sbStringToSign.getAsString())
    print("api_signature: \(api_signature!)")

    // --------------------------------------------------------------------
    // Here's an example showing how to use the signature in a request:

    // Build a new string-to-sign and create a new api_signature for the actual request we'll be sending...
    sbStringToSign.clear()
    sbStringToSign.append("GET")
    sbStringToSign.append("&")
    sbStringToSign.append("/app.shippingeasy.com/api/orders")
    sbStringToSign.append("&")
    sbStringToSign.append(queryParamsStr)
    sbStringToSign.append("&")
    // There is no body for a GET request.

    api_signature = crypt.macStringENC(sbStringToSign.getAsString())

    let http = CkoHttp()!
    let queryParams = CkoJsonObject()!

    queryParams.update("api_signature", value: api_signature)
    queryParams.update("api_timestamp", value: unixEpochTimestamp)
    queryParams.update("api_key", value: your_api_key)

    var resp: CkoHttpResponse? = http.quickRequestParams("GET", url: "https://app.shippingeasy.com/api/orders", json: queryParams)
    if http.lastMethodSuccess == false {
        print("\(http.lastErrorText!)")
        return
    }

    print("response status code = \(resp!.statusCode.intValue)")
    print("response body:")
    print("\(resp!.bodyStr!)")

    resp = nil

}