Objective-C

VoiceBase -- Upload a Media File with a JSON Configuration

See more VoiceBase Examples

This example uploads a media file and also provides a configuration file. Objective-C

#import <NSString.h>
#import <CkoHttp.h>
#import <CkoHttpRequest.h>
#import <CkoStringBuilder.h>
#import <CkoJsonObject.h>
#import <CkoJsonArray.h>
#import <CkoHttpResponse.h>

BOOL success = NO;

// This example assumes the Chilkat HTTP API to have been previously unlocked.
// See Global Unlock Sample for sample code.

// Insert your Bearer token here:
NSString *accessToken = @"VOICEBASE_TOKEN";

CkoHttp *http = [[CkoHttp alloc] init];

CkoHttpRequest *req = [[CkoHttpRequest alloc] init];
req.HttpVerb = @"POST";
req.Path = @"/v2-beta/media";
req.ContentType = @"multipart/form-data";

// Add the access (bearer) token to the request, which is a header
// having the following format:
// Authorization: Bearer <userAccessToken>
CkoStringBuilder *sbAuth = [[CkoStringBuilder alloc] init];
[sbAuth Append: @"Bearer "];
[sbAuth Append: accessToken];
[req AddHeader: @"Authorization" value: [sbAuth GetAsString]];

success = [req AddFileForUpload2: @"media" path: @"qa_data/wav/msg_123_abc.wav" contentType: @"audio/x-wav"];
if (success == NO) {
    NSLog(@"%@",req.LastErrorText);
    return;
}

// This is the JSON of the configuration to be added as a parameter to the upload:
// (Obviously, if you want a callback, you would use a URL that goes to your own web server..)

// 	{ 
// 	   "configuration":{ 
// 	      "publish":{ 
// 	         "callbacks":[
// 	            { 
// 	               "url":"https://www.chilkatsoft.com/dss/update_vm_transcription.asp",
// 	               "method":"POST",
// 	               "include":[
// 	                  "transcripts",
// 	                  "keywords",
// 	                  "topics",
// 	                  "metadata"
// 	               ]
// 	            }
// 	         ]
// 	      },
// 	      "keywords":{ 
// 	         "groups":[]
// 	      }
// 	   }
// 	}

// This code produces the above JSON.
CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"configuration.publish.callbacks[0].url" value: @"https://www.chilkatsoft.com/dss/update_vm_transcription.asp"];
[json UpdateString: @"configuration.publish.callbacks[0].method" value: @"POST"];
[json UpdateString: @"configuration.publish.callbacks[0].include[0]" value: @"transcripts"];
[json UpdateString: @"configuration.publish.callbacks[0].include[1]" value: @"keywords"];
[json UpdateString: @"configuration.publish.callbacks[0].include[2]" value: @"topics"];
[json UpdateString: @"configuration.publish.callbacks[0].include[3]" value: @"metadata"];

CkoJsonObject *jConfig = [[CkoJsonObject alloc] init];
[json ObjectOf2: @"configuration" jsonObj: jConfig];

CkoJsonObject *jKeywords = [[CkoJsonObject alloc] init];
[jConfig AppendObject2: @"keywords" jsonObj: jKeywords];

CkoJsonArray *jGroups = [[CkoJsonArray alloc] init];
[jKeywords AppendArray2: @"groups" jarr: jGroups];

// Add the configuration JSON to the upload.
[req AddParam: @"configuration" value: [json Emit]];

// Do the upload..
CkoHttpResponse *resp = [[CkoHttpResponse alloc] init];
success = [http HttpSReq: @"apis.voicebase.com" port: [NSNumber numberWithInt: 443] ssl: YES request: req response: resp];
if (success == NO) {
    NSLog(@"%@",http.LastErrorText);
    return;
}

// Examine the response status code and body.
NSLog(@"%@%d",@"Response status code = ",[resp.StatusCode intValue]);

// The response should be JSON, even if an error.
[json Load: resp.BodyStr];
json.EmitCompact = NO;

NSLog(@"%@",[json Emit]);

// A successful response will have a status code = 200
if ([resp.StatusCode intValue] != 200) {
    NSLog(@"%@",@"Failed.");
}
else {
    NSLog(@"%@%@",@"mediaId: ",[json StringOf: @"mediaId"]);
    NSLog(@"%@%@",@"href: ",[json StringOf: @"_links.self.href"]);
    NSLog(@"%@%@",@"status: ",[json StringOf: @"status"]);
    NSLog(@"%@",@"Success.");
}

// Here is an example of a successful response:

// 	{ 
// 	  "_links": { 
// 	    "self": { 
// 	      "href": "/v2-beta/media/856a1e85-c847-4c3c-b7a4-6cf15cd51db4"
// 	    }
// 	  },
// 	  "mediaId": "856a1e85-c847-4c3c-b7a4-6cf15cd51db4",
// 	  "status": "accepted",
// 	  "metadata": {}
//