Old Guides - You are viewing the guides for Ember v1.10.0. VIEW v3.12.0
Edit Page

The Rest Adapter

By default, your store will use DS.RESTAdapter to load and save records. The RESTAdapter assumes that the URLs and JSON associated with each model are conventional; this means that, if you follow the rules, you will not need to configure the adapter or write any code in order to get started.

URL Conventions

The REST adapter is smart enough to determine the URLs it communicates with based on the name of the model. For example, if you ask for a Post by ID:

store.find('post', 1).then(function(post) {

The REST adapter will automatically send a GET request to /posts/1.

The actions you can take on a record map onto the following URLs in the REST adapter:

ActionHTTP VerbURL
Find AllGET/people

Pluralization Customization

Irregular or uncountable pluralizations can be specified via Ember.Inflector.inflector:

var inflector = Ember.Inflector.inflector;

inflector.irregular('formula', 'formulae');

This will tell the REST adapter that requests for App.Formula requests should go to /formulae/1 instead of /formulas/1.

Endpoint Path Customization

Endpoint paths can be prefixed with a namespace by setting the namespace property on the adapter:

App.ApplicationAdapter = DS.RESTAdapter.extend({
  namespace: 'api/1'

Requests for App.Person would now target https://api.emberjs.com/1/people/1.

Host Customization

An adapter can target other hosts by setting the host property.

App.ApplicationAdapter = DS.RESTAdapter.extend({
  host: 'https://api.example.com'

Requests for App.Person would now target https://api.example.com/people/1.

JSON Conventions

When requesting a record, the REST adapter expects your server to return a JSON representation of the record that conforms to the following conventions.


The primary record being returned should be in a named root. For example, if you request a record from /people/123, the response should be nested inside a property called person:

  "person": {
    "firstName": "Jeff",
    "lastName": "Atwood"

Note: Although after destroyRecord or deleteRecord/save the adapter expects an empty object e.g. {} to be returned from the server after destroying a record.

If you don't have the option to change the data that the server responds with, you can override the DS.JSONSerializer#extractDeleteRecord, like so:

extractDeleteRecord: function(store, type, payload) {
  // payload is {delete: true} and then ember data wants to go ahead and set
  // the new properties, return null so it doesn't try to do that
  return null;

Attribute Names

Attribute names should be camelized. For example, if you have a model like this:

App.Person = DS.Model.extend({
  firstName: DS.attr('string'),
  lastName:  DS.attr('string'),

  isPersonOfTheYear: DS.attr('boolean')

The JSON returned from your server should look like this:

  "person": {
    "firstName": "Barack",
    "lastName": "Obama",
    "isPersonOfTheYear": true

Irregular keys can be mapped with a custom serializer. If the JSON for the Person model has a key of lastNameOfPerson, and the desired attribute name is simply lastName, then create a custom Serializer for the model and override the normalizeHash property.

App.Person = DS.Model.extend({
  lastName: DS.attr('string')

App.PersonSerializer = DS.RESTSerializer.extend({
  normalizeHash: {
    lastNameOfPerson: function(hash) {
      hash.lastName = hash.lastNameOfPerson;
      delete hash.lastNameOfPerson;

      return hash;


References to other records should be done by ID. For example, if you have a model with a hasMany relationship:

App.Post = DS.Model.extend({
  comments: DS.hasMany('comment', {async: true})

The JSON should encode the relationship as an array of IDs:

  "post": {
    "comments": [1, 2, 3]

Comments for a post can be loaded by post.get('comments'). The REST adapter will send a GET request to /comments?ids[]=1&ids[]=2&ids[]=3.

Any belongsTo relationships in the JSON representation should be the camelized version of the Ember Data model's name, with the string Id appended. For example, if you have a model:

App.Comment = DS.Model.extend({
  post: DS.belongsTo('post')

The JSON should encode the relationship as an ID to another record:

  "comment": {
    "post": 1

If needed these naming conventions can be overwritten by implementing the keyForRelationship method.

 App.ApplicationSerializer = DS.RESTSerializer.extend({
   keyForRelationship: function(key, relationship) {
      return key + 'Ids';

#### Sideloaded Relationships

To reduce the number of HTTP requests necessary, you can sideload
additional records in your JSON response. Sideloaded records live
outside the JSON root, and are represented as an array of hashes:

javascript { "post": { "id": 1, "title": "Node is not omakase", "comments": [1, 2, 3] },

"comments": [{ "id": 1, "body": "But is it lightweight omakase?" }, { "id": 2, "body": "I for one welcome our new omakase overlords" }, { "id": 3, "body": "Put me on the fast track to a delicious dinner" }] }

### Creating Custom Transformations

In some circumstances, the built in attribute types of `string`,
`number`, `boolean`, and `date` may be inadequate. For example, a
server may return a non-standard date format.

Ember Data can have new JSON transforms
registered for use as attributes:

javascript App.CoordinatePointTransform = DS.Transform.extend({ serialize: function(value) { return [value.get('x'), value.get('y')]; }, deserialize: function(value) { return Ember.create({ x: value[0], y: value[1] }); } });

App.Cursor = DS.Model.extend({ position: DS.attr('coordinatePoint') });

When `coordinatePoint` is received from the API, it is
expected to be an array:

javascript { cursor: { position: [4,9] } }

But once loaded on a model instance, it will behave as an object:

javascript var cursor = App.Cursor.find(1); cursor.get('position.x'); //=> 4 cursor.get('position.y'); //=> 9 ```

If position is modified and saved, it will pass through the serialize function in the transform and again be presented as an array in JSON.