Quick Start Guide for REST API

This guide will help you get up and running with Backendless quickly so you can start using the Backendless REST API in your applications.  At the end of the guide, you will have the basic knowledge of using the user registration and data persistence APIs. This guide uses the curl command line utility to generate REST requests sent to the Backendless servers.

  1. Login to your Backendless account or register to create a new one.
  2. Locate the Application ID and the REST API Key of your backend on the main dashboard screen. These values will be used later in the guide:
    App ID and REST API Key

  3. The first REST request you will send is to register a user for your app. Open a command prompt/terminal window and make sure you can run the curl command. All Backendless REST requests use the application ID and the REST API key in the endpoint URL. Make sure to substitute the <app-id> and <rest-api-key>  in the URLs below with the values for your app.
  4. A curl command to register a user is:

    Enter the command in your terminal window and press Enter.

  5. When the request finishes successfully, your response would look like the one in the screenshot below (the HTTP response code and response body are highlighted). If the HTTP code is 200 – then everything worked fine and the user is registered. The server response body is a JSON object representing the created user. !Note: to avoid showing verbose requests and responses we will not use the  “-v” flag in the subsequent curl examples in this guide
    rest-test-call-register-user
  6. You can verify that the user has been created by opening the Data screen of Backendless console. The user will appear in the Users table (which is selected by default).
  7.  Now that the user has been created, you can login that user with the command below:
    curl \
    -H Content-Type:application/json \
    -X POST \
    'https://api.backendless.com/<app-id>/<rest-api-key>/users/login' \
    -d '{"login":"john.smith@foo.bar", "password":"123456seven"}'
  8. Take a look at the response of the login operation. This is also a JSON object representing the logged-in user. The response body contains an important property called user-token ( it is marked with a white rectangle in the screenshot below ). Copy the value of that property:
    rest-api-login-response
  9. The next step is to create a data object (API doc) in the Backendless database. The object will be an arbitrary object called Comment. Notice that the request contains an HTTP header called user-token. It indicates that the request is made by a logged-in user (the same user who was logged-in in the previous step). The user automatically becomes the owner of the created object. Run the following command:
    curl \
    -H user-token:<value-obtained-from-server-in-step-8> \
    -H Content-Type:application/json \
    -X POST \
    'https://api.backendless.com/<app-id></rest-api-key>/data/Comment' \
    -d '{"message":"Hi, I am here!"}'
  10. The response sent by the server contains a JSON representation of the created Comment object. It has a system assigned fields:
    1.   objectId is assigned by Backendless and uniquely identifies the object in the database.
    2.   ownerId contains the objectId of the user who created the object.
      create-object-response
  11. Now you can refresh the Data screen of Backendless console and verify that the Comment table has been created and it contains an object created by user “john.smith@foo.bar”.

Enjoy!