Titanium Appcelerator Quickie: StackMob API Module Part One
This is an introductory post on using StackMob for the backend services of your mobile applications. The StackMob platform helps you build, deploy and scale your backend while making it very easy for you to add push notifications, social integration and more to your apps. Here is a blog posting on why services like StackMob are a value-add for Appcelerator developers.
Here is my brief outline on the benefits StackMob provides: More Information Available on website
- REST Based API
- Custom Code Integration
- Social Media Integration
- Push Notification
- Separation of Production and Staging Environments
In this initial example I have created, there are two simple objects: users and photos. We will expand on the relationship in a later posting, but this is good enough for now.
First you need to go to StackMob and get an account. They are still in beta, but if you indicate that you are trying to integrate with Appcelerator, they will give you priority access.
Create An App
Here we will create our user object. StackMob allows us to specify that the object is a user object and this is how we can log in and out of our application. No trying to roll your own authentication method. It is using xAuth over HTTPS, so you are all set.
Click “Create a Schema” to Add the User Object
then enter the appropriate information for your user object
When you are all done, you should have something that looks similar to this, if you have been following along.
Ok enough StackMob, where is the Appcelerator code….
First you need to initialize the module. I have created a file called
credentials which holds your StackMob credentials and associated application information. Here is what the file looks like.
Now with the credentials set, here is how you intialize the module.
And finally, here is how you create a user object to go along with the object you created in the console.
the successful output from the module should look something like this.
The client create method is a nice wrapper around a POST of the REST API call to create the user object. The whole objective of the module I created is to cut down on the time spent coding the oAuth API and get straight to doing productive things. The way the module is created, it will take the parameters and return the results as a JSON object
Here we make an API call through the module to get the list of all of the user(s) we have created in the system.
And to get a specific user, we can pass in the value for the user name in the GET query like this.
In Part Two I will cover setting up the Amazon S3 Integration and the uploading of image files to the system.