ApiOmat allows you to upload images to your backend. This is both up- and downloadable from a client app or the dashboard. If you choose to use images or files, remember the space limitation that comes with your chosen plan.

via Dashboard

Upload

One option is to upload the images using the dashboard. Simply create a new Module with an "image" attributed class and deploy your app. Now go to the “Data” Tab, add an object of that class and click into the table cell of the “Pictures”-Column. Choose the image you want to upload and confirm.

images/download/attachments/34177094/uploadImage.png

For files it’s pretty much the same.

images/download/attachments/34177094/uploadFile.png

Download

If you want to download a file or picture click on the picture icon in the dialog or on the clip.

images/download/attachments/34177094/downloadImage.png

via SDK

Upload

To upload an Image or a File from local storage , you have to convert it into a bytearray. If you already have your picture as bitmap you can convert it to a bytearray like this (android):

Android

ByteArrayOutputStream stream = new ByteArrayOutputStream();
bitmap.compress(Bitmap.CompressFormat.JPEG, 100, stream);
final byte[] byteArray = stream.toByteArray();
final Pictures picture = new Pictures();

Objective-C

//For Objective-C we use NSData instead of a byte array
 NSData* imageData = [[NSData alloc] initWithContentsOfURL: [NSURL URLWithString: @"http://www.apiomat.com/wp-content/uploads/2012/07/logo.png"]];

Swift

//For Swift we use Data instead of a byte array
var imageData: NSData?
if let url = URL(string: "http://www.apiomat.com/wp-content/uploads/2012/07/logo.png") {
 
	imageData = NSData(contentsOf: url)
}

JavaScript

var picture= new Apiomat.Picture();
 
var imgArr = [0,2,6,2];

Next, save an object of the class which should contain the picture on the server and post the picture after:

Android

picture.saveAsync(new AOMEmptyCallback() {
 
			@Override
			public void isDone(ApiomatRequestException exception) {
 
				picture.postPictureAsync(byteArray, new AOMEmptyCallback() {
 
					@Override
					public void isDone(ApiomatRequestException exception) {
 
 });

Objective-C

[picture saveAsyncWithBlock:^(NSError *error) {
	[picture postImageAsync:imageData andWithBlock:^(NSError *error) {
    }];
 }];

Swift

picture.save(completion: { (error) in
	picture.postImage(imageData) { (error) in
 
     }
}

JavaScript

var picturePostCB = {
    onOk : function() {
        console.log("saved");
       
    },
    onError : function(error) {
        console.log("Some error occured: (" + error.statusCode + ")" + error.message);
    }
};
 
picture.postImage(imgArr,picturePostCB);

That’s it. If you want to upload a file, it’s pretty much the same process:

Android

final File file = new File();
		file.saveAsync(new AOMEmptyCallback() {
			@Override
			public void isDone(ApiomatRequestException exception) {
				file.postDataAsync(byteArray, new AOMEmptyCallback() {
					@Override
					public void isDone(ApiomatRequestException exception) {
 
					}
				});
			}
		});

Objective-C

NSData *fileData = [NSData new]; //Get file data from anywhere
File *file = [File new];
[file saveAsyncWithBlock:^(NSError *error) {
	[file postDataAsync:fileData andWithBlock:^(NSError *error) {
	}];
}];

Swift

let fileData = NSData() //Get file data from anywhere
let file = File()
file.save(completion: { (error) in
	file.postData(fileData) { (error) in
	}
}

JavaScript

var file=new Apiomat.File();
var fileArr = [0,2,6,2];
 
var filePostCB = {
    onOk : function() {
        console.log("saved");
       
    },
    onError : function(error) {
        console.log("Some error occured: (" + error.statusCode + ")" + error.message);
    }
};
 
file.postFile(fileArr,filePostCB);

Download/Share

You can download or share your image, using the image URL. To get the URL do the following:

Android

picture.loadAsync(new AOMEmptyCallback() {
 
			@Override
			public void isDone(ApiomatRequestException exception) {
				Log.i("MainActivity", "LoadAsync is done");
				Log.i("MainActivity",
 
				picture.getPictureURL());
 
			}
		});

Objective-C

[picture loadAsyncWithBlock:^(NSError *error) {
	NSLog(@"LoadAsync is done");
	NSLog(@"%@", [picture pictureURL]);
}];

Swift

picture.loadImage { (data, error) in
 
	print("LoadAsync is done"
	print(picture.pictureUrl)
}

JavaScript

var loadCB = {
    onOk : function() {
        console.log("loaded");
        console.log(picture.getImageURL());	       
    },
    onError : function(error) {
        console.log("Some error occured: (" + error.statusCode + ")" + error.message);
    }
};
 
picture.load(loadCB);

If you want to scale you image on the server side adding following statements to the getPictureURL method:

Android

picture.getPictureURL(100, 200, "ffffff", null,"png"));

Objective-C

[picture scaledImageURLWithWidth:100 andHeight:200 andBGColor:@"ffffff" andAlpha:NULL andFormat:@"png"];

Swift

picture.loadScaledImage(width: 100, height: 200, backgroundColorAsHex: "ffffff", format: "png") { (data, error) in
}

JavaScript

picture.getImageURL(100, 200, "ffffff", null,"png"));

or in general:

Android

picture.getPictureURL(width, height, "backgroundcolorinhex", transparencyinfloat,
						"format"));

Objective-C

[picture scaledImageURLWithWidth:width andHeight:height andBGColor:@"backgroundcolorinhex" andAlpha:transparencyinfloat andFormat:@"format"];

Swift

picture.loadScaledImage(width: width, height: height, backgroundColorAsHex: "backgroundcolorinhex", alpha: transparencyinfloat, format: "format") { (data, error) in
}

JavaScript

picture.getImageURL(width, height, "backgroundcolorinhex", transparencyinfloat,"format"));

To get the URL of a file use this:

Android

final File file = new File();
		file.loadAsync(new AOMEmptyCallback() {
 
			@Override
			public void isDone(ApiomatRequestException exception) {
				file.getDateiURL();
			}
		});

Objective-C

File *file = [[File alloc] init];
[file loadAsyncWithBlock:^(NSError *error) {
	NSLog(@"%@", [file dataURL]);
}];

Swift

let file = File()
file.load { (error) in
	print(file.dataURL)
}

JavaScript

var loadCB = {
    onOk : function() {
        console.log("loaded");
        console.log(file.getFileURL());	       
    },
    onError : function(error) {
        console.log("Some error occured: (" + error.statusCode + ")" + error.message);
    }
};
 
file.load(loadCB);

via cURL

The REST API for managing images and files is documented here: http://apiomat.org/apidocs/#/apps

Upload

To upload an image, send a HTTP POST request to the REST resource https://apiomat.org/yambas/rest/apps/{appName}/data/images. You have to replace {appName} by the name of your app and send the picture’s data in the HTTP body. Optional parameters are the name and format of the picture.

For uploading a file there’s another REST resource: http://apiomat.org/yambas/rest/apps/{appName}/data/files, which works the same way.

To upload an image use this cURL command:

curl -F "file=@MYPICTURE.JPG" -F "apiKey=MYAPIKEY" -F "system=LIVE" -F "name=myimage" https://apiomat.org/yambas/rest/apps/MYAPPNAME/data/images

MYPICTURE.JPG stands for the location of your image while MYAPIKEY is a placeholder for the APIKey of your app which you can find in the App Setup screen of your dashboard. Also you have to replace MYAPPNAME within the URL with the name of your app.
If you want to upload a file just replace “images” with “files” within the URL.

This command returns the IMAGEID. You will need this ID to access this image later.

Download

If you upload a file or picture you receive the IMAGEID. You need the ID and the APIKey of your app to get the picture.

Then you can download the image as json from the resource http:apiomat.org/yambas/rest/apps/{appName}/data/images/{imageId}.
Or download the image as mimetype image with appending “.img” to this resource.

curl http://apiomat.org/yambas/rest/apps/MYAPP/data/images/IMAGEID.img?apiKey=YOURAPIKEY

You can also send the API key as a header instead of a parameter with the option -H “X-apiomat-apikey:YOURAPIKEY”.
As with uploading, downloading files instead of images works the same way, just use the resource http:apiomat.org/yambas/rest/apps/{appName}/data/images/{imageId}. Here you can append “.img” to download the file with its correct mimetype instead of json.

If you want to access a picture you’ve uploaded with cURL with an SDK, you can load the image from the href:

http://apiomat.org/yambas/rest/apps/MYAPP/data/images/IMAGEID.img?apiKey=MYAPIKEY

Again replace MYAPP with the name of your app, IMAGEID with the ID you received after unloading and MYAPIKEY with the APIKey of your app.

Image scaling and re-sizing

When downloading or embedding an image you can adjust some parameters in the URL to scale and resize the image, as well as setting a background color, alpha channel and transcode the image to a different format. You can find out how to do this in the REST API doc section.
The parameters width and height control the scaling and re-sizing. When you set both of them, the image gets re-sized. It’s up to you to keep or change the aspect ratio of the image. When you set just one of them, the image gets scaled with the other value automatically adjusted to keep the image’s original aspect ratio. For example, when you uploaded an image with 480×320 (w x h) pixel, and you download the image with the width set to 240 pixel, the height automatically gets set to 160 pixel and the aspect ratio of 4:3 stays the same.

The corresponding cURL command looks like this:

curl "https://apiomat.org/yambas/rest/apps/YOURAPPNAME/data/images/YOURIMAGEID.img?width=240&apiKey=YOURAPIKEY"

Tutorial Importing / Exporting Data

via Dashboard

Upload

Download

via SDK

Upload

Download/Share

via cURL

Upload

Download

Image scaling and re-sizing

Search results