Objective-C
Objective-C
MessageMedia - Send Messages
See more MessageMedia Examples
Submit one or more (up to 100 per request) SMS, MMS, or text to voice messages for delivery.Chilkat Objective-C Downloads
#import <CkoHttp.h>
#import <CkoJsonObject.h>
#import <CkoHttpResponse.h>
#import <CkoStringBuilder.h>
#import <NSString.h>
BOOL success = NO;
// This example assumes the Chilkat API to have been previously unlocked.
// See Global Unlock Sample for sample code.
CkoHttp *http = [[CkoHttp alloc] init];
// Implements the following CURL command:
// curl --request POST \
// --header "Content-Type: application/json" \
// --header "Accept: application/json" \
// --data-binary "{
// \"messages\": [
// {
// \"callback_url\": \"https://my.callback.url.com\",
// \"content\": \"My first message\",
// \"destination_number\": \"+61491570156\",
// \"delivery_report\": true,
// \"format\": \"SMS\",
// \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",
// \"metadata\": {
// \"myKey\": \"myValue\",
// \"anotherKey\": \"anotherValue\"
// },
// \"scheduled\": \"2016-11-03T11:49:02.807Z\",
// \"source_number\": \"+61491570157\",
// \"source_number_type\": \"INTERNATIONAL\"
// },
// {
// \"callback_url\": \"https://my.callback.url.com\",
// \"content\": \"My second message\",
// \"destination_number\": \"+61491570158\",
// \"delivery_report\": true,
// \"format\": \"MMS\",
// \"subject\": \"This is an MMS message\",
// \"media\": [ \"https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg\" ],
// \"message_expiry_timestamp\": \"2016-11-03T11:49:02.807Z\",
// \"metadata\": {
// \"myKey\": \"myValue\",
// \"anotherKey\": \"anotherValue\"
// },
// \"scheduled\": \"2016-11-03T11:49:02.807Z\",
// \"source_number\": \"+61491570159\",
// \"source_number_type\": \"INTERNATIONAL\"
// }
// ]
// }" \
// https://private-anon-ecbaffbc28-messages32.apiary-mock.com/v1/messages
// Use the following online tool to generate HTTP code from a CURL command
// Convert a cURL Command to HTTP Source Code
// Use this online tool to generate code from sample JSON:
// Generate Code to Create JSON
// The following JSON is sent in the request body.
// {
// "messages": [
// {
// "callback_url": "https://my.callback.url.com",
// "content": "My first message",
// "destination_number": "+61491570156",
// "delivery_report": true,
// "format": "SMS",
// "message_expiry_timestamp": "2016-11-03T11:49:02.807Z",
// "metadata": {
// "myKey": "myValue",
// "anotherKey": "anotherValue"
// },
// "scheduled": "2016-11-03T11:49:02.807Z",
// "source_number": "+61491570157",
// "source_number_type": "INTERNATIONAL"
// },
// {
// "callback_url": "https://my.callback.url.com",
// "content": "My second message",
// "destination_number": "+61491570158",
// "delivery_report": true,
// "format": "MMS",
// "subject": "This is an MMS message",
// "media": [
// "https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg"
// ],
// "message_expiry_timestamp": "2016-11-03T11:49:02.807Z",
// "metadata": {
// "myKey": "myValue",
// "anotherKey": "anotherValue"
// },
// "scheduled": "2016-11-03T11:49:02.807Z",
// "source_number": "+61491570159",
// "source_number_type": "INTERNATIONAL"
// }
// ]
// }
CkoJsonObject *json = [[CkoJsonObject alloc] init];
[json UpdateString: @"messages[0].callback_url" value: @"https://my.callback.url.com"];
[json UpdateString: @"messages[0].content" value: @"My first message"];
[json UpdateString: @"messages[0].destination_number" value: @"+61491570156"];
[json UpdateBool: @"messages[0].delivery_report" value: YES];
[json UpdateString: @"messages[0].format" value: @"SMS"];
[json UpdateString: @"messages[0].message_expiry_timestamp" value: @"2016-11-03T11:49:02.807Z"];
[json UpdateString: @"messages[0].metadata.myKey" value: @"myValue"];
[json UpdateString: @"messages[0].metadata.anotherKey" value: @"anotherValue"];
[json UpdateString: @"messages[0].scheduled" value: @"2016-11-03T11:49:02.807Z"];
[json UpdateString: @"messages[0].source_number" value: @"+61491570157"];
[json UpdateString: @"messages[0].source_number_type" value: @"INTERNATIONAL"];
[json UpdateString: @"messages[1].callback_url" value: @"https://my.callback.url.com"];
[json UpdateString: @"messages[1].content" value: @"My second message"];
[json UpdateString: @"messages[1].destination_number" value: @"+61491570158"];
[json UpdateBool: @"messages[1].delivery_report" value: YES];
[json UpdateString: @"messages[1].format" value: @"MMS"];
[json UpdateString: @"messages[1].subject" value: @"This is an MMS message"];
[json UpdateString: @"messages[1].media[0]" value: @"https://images.pexels.com/photos/1018350/pexels-photo-1018350.jpeg?cs=srgb&dl=architecture-buildings-city-1018350.jpg"];
[json UpdateString: @"messages[1].message_expiry_timestamp" value: @"2016-11-03T11:49:02.807Z"];
[json UpdateString: @"messages[1].metadata.myKey" value: @"myValue"];
[json UpdateString: @"messages[1].metadata.anotherKey" value: @"anotherValue"];
[json UpdateString: @"messages[1].scheduled" value: @"2016-11-03T11:49:02.807Z"];
[json UpdateString: @"messages[1].source_number" value: @"+61491570159"];
[json UpdateString: @"messages[1].source_number_type" value: @"INTERNATIONAL"];
[http SetRequestHeader: @"Content-Type" value: @"application/json"];
[http SetRequestHeader: @"Accept" value: @"application/json"];
CkoHttpResponse *resp = [[CkoHttpResponse alloc] init];
success = [http HttpJson: @"POST" url: @"https://private-anon-ecbaffbc28-messages32.apiary-mock.com/v1/messages" json: json contentType: @"application/json" response: resp];
if (success == NO) {
NSLog(@"%@",http.LastErrorText);
return;
}
CkoStringBuilder *sbResponseBody = [[CkoStringBuilder alloc] init];
[resp GetBodySb: sbResponseBody];
CkoJsonObject *jResp = [[CkoJsonObject alloc] init];
[jResp LoadSb: sbResponseBody];
jResp.EmitCompact = NO;
NSLog(@"%@",@"Response Body:");
NSLog(@"%@",[jResp Emit]);
int respStatusCode = [resp.StatusCode intValue];
NSLog(@"%@%d",@"Response Status Code = ",respStatusCode);
if (respStatusCode >= 400) {
NSLog(@"%@",@"Response Header:");
NSLog(@"%@",resp.Header);
NSLog(@"%@",@"Failed.");
return;
}
// Sample JSON response:
// (Sample code for parsing the JSON response is shown below)
// {
// "messages": [
// {
// "message_id": "04fe9a97-a579-43c5-bb1a-58ed29bf0a6a",
// "callback_url": "https://my.url.com",
// "status": "delivered",
// "content": "My first message",
// "destination_number": "+61491570156",
// "delivery_report": true,
// "format": "SMS",
// "message_expiry_timestamp": "2016-11-03T11:49:02.807Z",
// "metadata": {
// "myKey": "myValue",
// "anotherKey": "anotherValue"
// },
// "scheduled": "2016-11-03T11:49:02.807Z",
// "source_number": "+61491570157",
// "source_number_type": "INTERNATIONAL"
// }
// ]
// }
// Sample code for parsing the JSON response...
// Use the following online tool to generate parsing code from sample JSON:
// Generate Parsing Code from JSON
NSString *message_id = 0;
NSString *callback_url = 0;
NSString *status = 0;
NSString *content = 0;
NSString *destination_number = 0;
BOOL delivery_report;
NSString *format = 0;
NSString *message_expiry_timestamp = 0;
NSString *MyKey = 0;
NSString *AnotherKey = 0;
NSString *scheduled = 0;
NSString *source_number = 0;
NSString *source_number_type = 0;
int i = 0;
int count_i = [[jResp SizeOfArray: @"messages"] intValue];
while (i < count_i) {
jResp.I = [NSNumber numberWithInt: i];
message_id = [jResp StringOf: @"messages[i].message_id"];
callback_url = [jResp StringOf: @"messages[i].callback_url"];
status = [jResp StringOf: @"messages[i].status"];
content = [jResp StringOf: @"messages[i].content"];
destination_number = [jResp StringOf: @"messages[i].destination_number"];
delivery_report = [jResp BoolOf: @"messages[i].delivery_report"];
format = [jResp StringOf: @"messages[i].format"];
message_expiry_timestamp = [jResp StringOf: @"messages[i].message_expiry_timestamp"];
MyKey = [jResp StringOf: @"messages[i].metadata.myKey"];
AnotherKey = [jResp StringOf: @"messages[i].metadata.anotherKey"];
scheduled = [jResp StringOf: @"messages[i].scheduled"];
source_number = [jResp StringOf: @"messages[i].source_number"];
source_number_type = [jResp StringOf: @"messages[i].source_number_type"];
i = i + 1;
}