Creating

URL

POST to the following URL:

http://rest.wasabisync.com/client_apps/<appId>/users/<userId>/known_objects.json

Parameters:

• appId - The application id which will receive your data. This should be of the form: com.yourcompany.yourapplication
• userId - The id of the user who will own the object you are posting. Typically, this will be an email address.

Payload

The payload of this call should contain a JSON dictionary containing the following keys:

• object - The object to be created. This should match the Wasabi JSON Object Definition.
• objtype - The name of the type of object to be created. This should match an entity type in your applications managed object model.
• schema_version - The version of the schema from your managed object model to use in creating and storing this object.

Result

• 2xx - Success.

Discussion

When you post your data to the server using the REST API, it will look up the schema version that you have specified, and the server must already know the details of that schema. The server learns about your schema when applications using the transaction API post transactions to the server. Therefore in order to use the REST API to create objects, you have to have had at least one client application synchronize with the server using the schema version that you hope to use with the REST API.

Example JSON Payload:

{
  "objtype": "TestEntity",
  "schema_version": "1.0",
  "object": {
    "attributes": {
      "guid": "FEB0BD13-AEF7-41F7-AAAC-397ED487603E",
      "testString": "foo"
    },
    "relationships": {
      "bar": [
        "0956e6af-6f4d-4207-abff-23835a3e693a"
      ]
    }
  }
}