REST API database on cloud

Auto Generated Code to perform database operations

No matter what technology you are using, after building each database class you can find and use auto-generated code to perform CRUD (Create, Read, Update, Delete) operations.

const MyCustomClass = Parse.Object.extend('MyCustomClassName');
const myNewObject = new MyCustomClass();

myNewObject.set('myCustomKey1Name', 'myCustomKey1Value');
myNewObject.set('myCustomKey2Name', 'myCustomKey2Value');

myNewObject.save().then(
   (result) => {
     if (typeof document !== 'undefined') document.write(`ParseObject created: ${JSON.stringify(result)}`);
     console.log('ParseObject created', result);
   },
   (error) => {
     if (typeof document !== 'undefined') document.write(`Error while creating ParseObject: ${JSON.stringify(error)}`);
     console.error('Error while creating ParseObject: ', error);
   }
);

Javascript | Documentation

var parseObject = PFObject(className:"MyCustomClassName")
parseObject["myCustomKey1Name"] = "My custom value"
parseObject["myCustomKey2Name"] = 999
// Saves the new object.
parseObject.saveInBackground {
   (success: Bool, error: Error?) in
   if (success) {
     // The object has been saved.
   } else {
     // There was a problem, check error.description
   }
}

Swift | Documentation

PFObject *parseObject = [PFObject objectWithClassName:@"MyCustomClassName"];
parseObject[@"myCustomKey1Name"] = @"My custom value";
parseObject[@"myCustomKey2Name"] = @999;
[parseObject saveInBackgroundWithBlock:^(BOOL succeeded, NSError *error) {
   if (succeeded) {
     // The object has been saved.
   } else {
     // There was a problem, check error.description
   }
}];

Objective-C | Documentation

public void createObject() {
   String myCustomKey1Value = "foo";
   Integer myCustomKey2Value = 999;
   ParseObject myNewObject = new ParseObject("MyCustomClassName");
   myNewObject.put("myCustomKey1Name", myCustomKey1Value);
   myNewObject.put("myCustomKey2Name", myCustomKey2Value);
   // Saves the new object.
   // Notice that the SaveCallback is totally optional!
   myNewObject.saveInBackground(new SaveCallback() {
     @Override
     public void done(ParseException e) {
       // Here you can handle errors, if thrown. Otherwise, "e" should be null
     }
   });
}

Android | Documentation

ParseObject myCustomClass = new ParseObject("MyCustomClassName");
myCustomClass["myCustomKey1Name"] = "My custom value";
myCustomClass["myCustomKey2Name"] = 999;
await myCustomClass.SaveAsync();

Xamarin | Documentation

curl -X POST \
-H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
-H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
-H "Content-Type: application/json" \
-d '{"myCustomKey1Name":"myCustomKey1Value","myCustomKey2Name":"myCustomKey2Value"}' \
https://parseapi.back4app.com/classes/MyCustomClassName

REST API | Documentation

const MyCustomClass = Parse.Object.extend('MyCustomClassName');
const query = new Parse.Query(MyCustomClass);
query.equalTo("myCustomKey1Name", "myCustomKey1Value");
query.find().then((results) => {
   // You can use the "get" method to get the value of an attribute
   // Ex: response.get("<ATTRIBUTE_NAME>")
   if (typeof document !== 'undefined') document.write(`ParseObjects found: ${JSON.stringify(results)}`);
   console.log('ParseObjects found:', results);
}, (error) => {
   if (typeof document !== 'undefined') document.write(`Error while fetching ParseObjects: ${JSON.stringify(error)}`);
   console.error('Error while fetching ParseObjects', error);
});

Javascript | Documentation

var query = PFQuery(className:"MyCustomClassName")
query.getObjectInBackgroundWithId("<PARSE_OBJECT_ID>") {
   (parseObject: PFObject?, error: NSError?) -> Void in
   if error == nil && parseObject != nil {
     print(parseObject)
   } else {
     print(error)
   }
}

Swift | Documentation

PFQuery *query = [PFQuery queryWithClassName:@"MyCustomClassName"];
[query getObjectInBackgroundWithId:@"<PARSE_OBJECT_ID>" block:^(PFObject *parseObject, NSError *error) {
// Do something with the returned PFObject in the parseObject variable.
NSLog(@"%@", parseObject);
}];

Objective-C | Documentation

public void readObject() {
   ParseQuery<ParseObject> query = ParseQuery.getQuery("MyCustomClassName");
   // The query will search for a ParseObject, given its objectId.
   // When the query finishes running, it will invoke the GetCallback
   // with either the object, or the exception thrown
   query.getInBackground("<PARSE_OBJECT_ID>", new GetCallback<ParseObject>() {
     public void done(ParseObject result, ParseException e) {
       if (e == null) {
         System.out.println(result);
       } else {
         // something went wrong
       }
     }
   });
}

Android | Documentation

ParseQuery<ParseObject> query = ParseObject.GetQuery("MyCustomClassName");
ParseObject result = await query.GetAsync("<PARSE_OBJECT_ID>");
// Use the Get<T> method to get the values
string myCustomKey1 = result.Get<string>("myCustomKey1Name");
int myCustomKey2 = result.Get<int>("myCustomKey2Name");
// The same method is applied to the default properties
string objectId = result.ObjectId;
DateTime? updatedAt = result.UpdatedAt;
DateTime? createdAt = result.CreatedAt;

Xamarin | Documentation

curl -X GET \
-H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
-H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
-G \
--data-urlencode "where={\"myCustomKey1Name\":\"myCustomKey1Value\"}" \
https://parseapi.back4app.com/classes/MyCustomClassName

REST API | Documentation

const MyCustomClass = Parse.Object.extend('MyCustomClassName');
const query = new Parse.Query(MyCustomClass);
// here you put the objectId that you want to update
query.get('xKue915KBG').then((object) => {
   object.set('myCustomKey1Name', 'new value');
   object.save().then((response) => {
     // You can use the "get" method to get the value of an attribute
     // Ex: response.get("<ATTRIBUTE_NAME>")
     if (typeof document !== 'undefined') document.write(`Updated : ${JSON.stringify(response)}`);
     console.log('Updated ', response);
   }, (error) => {
     if (typeof document !== 'undefined') document.write(`Error while updating : ${JSON.stringify(error)}`);
     console.error('Error while updating ', error);
   });
});

Javascript | Documentation

var query = PFQuery(className:"MyCustomClassName")
query.getObjectInBackgroundWithId("<PARSE_OBJECT_ID>") {
(parseObject: PFObject?, error: NSError?) -> Void in
if error == nil && parseObject != nil {
   parseObject["myCustomKey1Name"] = "My custom value"
   parseObject["myCustomKey2Name"] = 999
   parseObject.saveInBackground()
} else {
   print(error)
}
}

Swift | Documentation

PFQuery *query = [PFQuery queryWithClassName:@"MyCustomClassName"];
// Retrieve the object by id
[query getObjectInBackgroundWithId:@"<PARSE_OBJECT_ID>"
   block:^(PFObject *parseObject, NSError *error) {
   parseObject[@"myCustomKey1Name"] = @"My custom value";
   parseObject[@"myCustomKey2Name"] = @999;
   [parseObject saveInBackground];
}];

Objective-C | Documentation

public void updateObject() {
   ParseQuery<ParseObject> query = ParseQuery.getQuery("MyCustomClassName");
   // Retrieve the object by id
   query.getInBackground("<PARSE_OBJECT_ID>", new GetCallback<ParseObject>() {
     public void done(ParseObject entity, ParseException e) {
       if (e == null) {
         // Update the fields we want to
         entity.put("myCustomKey1Name", "My new value");
         entity.put("myCustomKey2Name", 999);
         // All other fields will remain the same
         entity.saveInBackground();
       }
     }
   });
}

Android | Documentation

ParseQuery<ParseObject> query = ParseObject.GetQuery("MyCustomClassName");
ParseObject object = await query.GetAsync("<PARSE_OBJECT_ID>");
object["myCustomKey1Name"] = "My new value";
await object.SaveAsync();

Xamarin | Documentation

// cURL

curl -X PUT \
-H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
-H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
-H "Content-Type: application/json" \
-d '{"myCustomKeyName":"newValue"}' \
https://parseapi.back4app.com/classes/MyCustomClassName/PARSE_OBJECT_ID

REST API | Documentation

const MyCustomClass = Parse.Object.extend('MyCustomClassName');
const query = new Parse.Query(MyCustomClass);
// here you put the objectId that you want to delete
query.get('xKue915KBG').then((object) => {
   object.destroy().then((response) => {
     if (typeof document !== 'undefined') document.write(`Deleted ParseObject: ${JSON.stringify(response)}`);
       console.log('Deleted ParseObject', response);
   }, (error) => {
     if (typeof document !== 'undefined') document.write(`Error while deleting ParseObject: ${JSON.stringify(error)}`);
     console.error('Error while deleting ParseObject', error);
   });
});

Javascript | Documentation

var deleteAttributesOnly = true
var query = PFQuery(className:"")
query.getObjectInBackgroundWithId("<PARSE_OBJECT_ID>") {
   (parseObject: PFObject?, error: NSError?) -> Void in
   if error != nil {
     print(error)
   } else if parseObject != nil {
     if deleteAttributesOnly {
       parseObject.saveInBackground()
     } else {
       parseObject.deleteInBackground()
     }
   }
}

Swift | Documentation

PFQuery *query = [PFQuery queryWithClassName:@"MyCustomClassName"];

// Retrieve the object by id
[query getObjectInBackgroundWithId:@"<PARSE_OBJECT_ID>" block:^(PFObject *parseObject, NSError *error) {
[parseObject deleteInBackground];
}

Objective-C | Documentation

public void deleteObject() {
   // TODO: modify me!
   final boolean deleteAttributesOnly = true;

   ParseQuery<ParseObject> query = ParseQuery.getQuery("MyCustomClassName");

   // Retrieve the object by id
   query.getInBackground("<PARSE_OBJECT_ID>", new GetCallback<ParseObject>() {
     public void done(ParseObject entity, ParseException e) {
       if (e == null) {
         if (deleteAttributesOnly) {
           // If you want to undefine a specific field, do this:
           entity.remove("myCustomKey1Name");

           // Then save the changes
           entity.saveInBackground();
         } else {
           // Otherwise, you can delete the entire ParseObject from the database
           entity.deleteInBackground();
         }
       }
     }
   });
}

Java | Documentation

ParseQuery<ParseObject> query = ParseObject.GetQuery("MyCustomClassName");
ParseObject myObject = await query.GetAsync("<PARSE_OBJECT_ID>");
await myObject.DeleteAsync();

Xamarin | Documentation

curl -X DELETE \
-H "X-Parse-Application-Id: YOUR_APP_ID" \
-H "X-Parse-REST-API-Key: YOUR_REST_API_KEY>" \
https://parseapi.back4app.com/classes/MyCustomClassName/PARSE_OBJECT_ID

REST API | Documentation

Performance at Scale

Back4App supports some of the world’s largest scale applications(delivering more than 20.000 requests per second in some cases) by providing consistent, fast response times at any scale. We are prepared to scale your database anytime using features like smart database index, queries optimizers, auto-scaling, automated backups, redundant storage capacity.

True Serverless

Forget about manage indexes, files, network, replica sets, database software updates, backups. With Back4App, there are no low-level configuration or setup to use your database. With a single click you create a complete hosted database with api to manipulate your data.

True Serverless

Enterprise Ready

We can customize a plan according to your consumption profile and provide dedicated clusters or on-premises deployment packages. On the security side, Back4App is compliant with some important worldwide security data regulations like GDPR. Additionally, we can encrypt all data by default and provides fine-grained identity and access control on all your tables.

Oops!

Oops!

Session expired

REST API database on cloud

Auto Generated Code to perform database operations

Performance at Scale

True Serverless

True Serverless

Enterprise Ready

Sign Up and start saving your data in seconds